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The EMC Data Manager Software Reference mznual is iJie core 
document tliat is provided to customers who purchase either an 
EMC Data Manager (EDM) or EDM with the Hierarcliical Storage 
Management (HSM) Option. 

'I'his manual provides comprehensive reference information 
about Backup, Restore, Volume Management, and optional HSM 
software. This manual introduces basic EDM software concepts 
and describes the programs, reports, and log files that you use 
in conjunction with the EDM interlace. It also provides overall 
disaster recovery instructions for the EDM seiver. 

This manual describes the following: 

• Basic Backup and Restore Concepts 

• Volume Management and Duplication Concepts 

• Basic HSM Concepts 

• Logs and Repoits 

• Command Line Interfaces 
» Disaster Recoveiy 

• Configuration Files 
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Who Should Use This This manual is intended for system adniinistratoi's wJio are 

f^SnUSl responsible for administering and operating an EMC Data 

Manager (EDM) or EDM with HSM Option. You should be 
familiar with UNIX system administration, understand your 
network environment, and understand the requirements of the 
various groups that you serve. 



How to Got the hiformation about the EMC Data Manager is available tlirough 

Information You Need the graphical user interface (GUI) online help and online books, 

as well as hardcopy documentation, as described in the 

following sections. 



Online Help and Online Books -Hie EDM graphical user interface Help facilit)' provides detailed 
information and procedures for managing the EDM seiver, its 
clients, and library units. 

To access online help, log in to tlie EDM. Enter edm to display 
the EDM Main window, then click on the Help liutton. llie 
Help facilit}' includes context-sensitive help for input fields, 
window areas, options, and buttons. Online Help also includes 
step-by-step instructions for tasks that you perform to manage 
and monitor flie EDM seiTer. 

Also available are online versions of selected manuals, To 
access these online books, select Help in the EDM Main 
window menu bar, then Online Books. 
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Hardcopy Documentation The following documentation is available for use with EMC 

Data Manager (EDM) or EDM with HSM Option. 

• EDM Software Reference (P/'N 300-1 1 3-001 ) 

• EDM Softivare Release Notes (P/N 300-1 13-004) 

• EDM Storage Devices (P/'N 300-1 13-002) 

• EDM Server Error Messages (P/N 300-1 13-01 4) 



Symmetrix Path and Symmetrix The EDM Symmetrix Path User Guide (P/N 300-1 1 3-007) 

Connect provides information for configuring, backing up, and restoring 

data using EDM Symmetrix Path. 

The EDM Symmetrix Connect User Guide (P/N 300-113-005), the 
EDM Symmetrix Connect Quich Reference Card (P/N 300-113- 
006), and the Symmetrix Connect Checklist (P/N 300-113-011) 
provide information for configuring, backing up, and restoring 
data using EDM Symmetrix Connect. 



Clients and Databases The following EMC Data Manager supplemental guides provide 

installation and configuration insti'uctions for setting up the 
EDM backup clients. Release notes are also available. 

• NetWare Backup Client (P/N 300-1 14-001) 

• OS/2 Backup Client (P/N 3(X)- 1 1 8-001) 

• Windows NT Backup Client (P/N 300-1 19-001) 

• OpenVMS Backup Client (P/N 300-122-001 ) 

• Oracle Backup Client (P/N 300-1 15-001) 

• Sybase Backup Client (P/N 300-1 1 6-001 ) 

• Inform ix Backup Client (P/N 300-1 17-001) 

• EMC Backint for SAP R/3 System (P/N 300-120-(Xll) 

• Windows NT SQL Server Backup (P/N 300-1 21-001 ) 

• Windows NT Oracle Backup Client (P/N 3(X)-1 1 5-003) 
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e Windows NT Exchange Backup Client ( P/N 300-119-003) 
• Windows NT Lotus Notes Backup Client (P/N 300-1 19-005) 



Notes and Cautions Notes provide clarification or additional important information. 

Note: It calls your attention to an operating procedure, 
practice, condition, or similar situation which is 
important to highlight. 

Cautions are used to indicate the presence of a hazard. 

CAUTION: It calls your attention to an operating 

procedure, practice, condition, or similar 
situation. Failure to observe a caution can 
result in minor personal injury, damage to 
a program, device, system, or loss of data. 



If you need teclinical assistance with the EDM system, 
contact the EMC support hot line at: 
1 800 SVC-4EMC (1 800 782-4362) 

If you are located outside the United States or Canada, 
contact the nearest EMC office for assistance. 



Reader's Comments We welcome your comments on this documentation. 

Send e-mail to: 

doc_comments@mil.emc.com 

Please include the part number and title of the manual. 



Technical Support 
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Basic Backup 
and Restore 
Concepts 



EDM Basics 



EMC Data Manager (EDM) is an integrated solution for 
unattended backup ol' data over your network, EDM Symmetrix 
Path, oi- EDM Symmetrix Connect. 

The EMC Data Manager is a full-featured, client/server backup 
system that offers fast and reliable backup processing with 
minima] operator intervention. 

Witli its graphical user interface (GUI) and built-in intelligent 
sclieduling, EDM Backup software fully manages the complete 
backup process to ensure maximum protection of all data in a 
client/server environment. 

Tliis chapter describes the following topics: 

• EDM Ovendew 

• EDM Hardware 

• EDM Software 

• EDM Grapliical User Interface 
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EDM Overview EMC Data Manager backs up data from magnetic disk to the 

magnetic tape, backing up both databases, tablespaces, and 
filesystems. EDM writes tlie backup data to tape cartridges 
within one or more tape Hbrary units attached tt:> tlie EDM. hi so 
doing, EDM gives you the ability to perfomi restores of data lost 
by physical disk failure and restores of data lost by removal 
(logically) from the disk. 

EDM backs up ckita from bodi Symmetrix-attached computers 
and from networked computers. For Symmetrix-attached 
computers, EDM's high-performance Symmetrix Connect and 
Symmetrix Patli options offer rapid transfer of large amounts of 
backup data over Fibre-Channel or SCSI cabling between the 
Symmetrix and EDM. For computers that are not attached to a 
Symmetrix, EDM transfers backup data over the network. 



Figure 1-1 EDM Symmetrix and Network Backup Environment 



FDDI/Ethernet/Token Ring/ATM 
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With its Hierarcliical Storage Management (HSM) option, EDM 
migrates less-used filesystem data from magnetic disks to optical 
disks located in attached optical library? units. One benefit of 
HSM is to reduce full backup loads. 

The EDxM Backup software maintains catalogs of tlie backups 
on disk storage, and restores filesystem and database data from 
magnetic tape to the client. 

The EDM softx^i-are also controls the operation of robotics, 
drives, and cartridges located inside tape library units. 
State-of-the-art product features include a multi-threaded libraiy 
manager, media duplication capabilit}', and ATL Storljnk 
support. 

A graphical user interface enables you to configure and manage 
tape operations, and network backups and restores of backed 
up files and databases. 



The EDM system includes both tlie hardware and software 
components that are needed to backup and restore data, llie 
EDM hardware consists of: 

• an EDM cabinet containing: a server unit, magnetic disks for 
online catalogs, and optional internal tape libraiy unit 

• a color system console, keyboard, mouse, and modem 

• attached external tape libraiy units (DLT, 8mm) and/or 
optical libraiy units (EO, WORM) 

EDM software components include a Sun Solaris operating 
system and EDM Backup software (which includes system 
monitoring support software). Tlie software is installed by EMC 
and vendor factory and/or EMC Customer Service personnel. 
Optionally included are Sun ATM, FDDI, Ethernet, and/or 
Token Ring card device driver software, and EMC Hierarchical 
Storage .Management (HSM) software. 
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Network Backup and Restore over die network, EDA4 can back up from a broad selection of 
UNIX and Windows NT platforms and PC clients acting as 
fileservers, database management systems, and application 
workstations. Computer platforms in the EDM network 
environment include the EDM itself and the other hosts tliat you 
configure as network backup clients. (Refer to the EMC Data 
Manager Software Release Notes for a current list of supported 
clients for network and direct connect backup.) Data from each 
host is streained over the TCP/IP network to the EDM, which 
writes the data to tape library units (TLUs) that are attached to it 
through .SCSI connections. Figure 1-2 illustrates an EDM 
network environment. 



EDM Network Backup and Restore Environment 

FDDI/Ethernet/Token Ring/ATM 





Network (TCP/IP) 






Hosts 






EDM 


Tape 


















Backup 


Library 


0 




□ 




0 




0 




Server, 


Unit 




















The EDM sofnvare maintains catalogs of the backups to enable 
easy interactive restoring whenever necessary'. Tlie backup 
catalogs are stored online on the disk subsystem in or external 
to tlie EDM cabinet. 
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EDM performs online, full and increiiiental backups of 
filesystems. Full backups copy the entire filesystem, while incre- 
mentals just copy tliose files that have been added or changed 
since the previous backup. (Incremental backups also note 
down any files that have been deleted, ) EDM can back up 
databases online or offline, as applicable to particular database 
systems. 

As EDM system administi-ator, you can automate filesystem 
backups and you can also initiate backups and restores on 
demand from die EDM. Also, you can optionally configure the 
restore feature to enable some or all of your workstation and 
filesei'ver users to restore their own files and filesystems without 
your assistance. 

In most cases, database backups can be either client-initiated or 
EDM-initiated. With client-initiated backups, the database 
administrators manage their own database backups and restores 
from die database server (the client system to the EDM), Widi 
EDM-initiated backups, you can configure automated schedules 
as well as initiate backups on demand. In a few cases, database 
backups can only be EDM-initialed, and in a few cases, only 
client-initiated. Similarly, in many cases, database restores can 
either be EDM-initiated or client-initiated. But in some cases, 
database restores can be EDM-initiated only, and in other cases, 
client-initiated only. 



EDM SymmetriX Path with EDM Symmetrix Patli, you can back up and restore many 

of the same types of databases and filesystems that you can 
over the netvv'ork, hut the data is transferred through a 
Symmetrix instead of over the network. (Refer to tlie EMC Data 
Manager Software Release AWes for a current list of supported 
client platforms.) The EDM Symmetrix Path option backs up 
large databases and filesystems through the Symmetrix cable 
connections, thereby bypassing the netv^^ork's limited speed and 
bandwidth. 



EDM Software Reference 



1-6 



EDM Basics 



With tliis methodology, the EDM server and a client system are 
both cabled to a Symmetrix and the Symmetrix itself acts as the 
network, A few small devices on the Symmetrix are designated 
as transport paths for configuration pinposes, while the actual 
dam transport is generally handled by cache memory. Various 
device configurations and host mapping combinations are 
possible to provide different performance characteristics and 
degrees of flexibitit}'. 

Symmetrix Path can backup data residing on the locally 
attached disks of a Symmetrix -attached computer, as well as 
data on Symmetrix disks. Refer to die EMC Data Manager 
Symmetrix Path User Guide for more inJbrmalion about this 
feature. 



EDM Symmetrix Connect The EIVIC Data Manager Symmetrix Connect feature pemiits a 

high speed online or offline backup and restore of a client's 
very large UNIX filesystem, Windows NT, Oracle?, OracleS, or 
Oracle8i dataf^ase (or a copy) that resides on one or more 
Symmetrix systems. 

EI3M Symmetrix Connect backs up data residing on Symmetrix 
disks, eitlier on so-called min'ored volumes — TimeFinder 
Business Continuance Volumes (BCVs) or Symmetrix Remote 
Data Facility- (SRDF) target (R2) volumes — or on unmiri-ored 
volumes — TimeFinder standard devices (STDs) or SRDF source 
(RD volumes. 

Symmetrix Connect provides EDM-specific interfaces to back up 
database and filesystem data on UNIX and Windows NT clients. 
For UNIX systems (IBM, Compaq, FIP, Sequent, and Sun), the 
EDM Oracle Application Inteiface backs up Oracle7/8/8i 
databases and filesystems. On Windows WY clients, various 
EDM-specific interfaces enable backup of filesystems, Oracle 
Backup, SQL Server, and Exchange. 
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Symmetrix Connect also backs up UNIX Oracle databases 
through ts\fo standard interfaces. One is OracleS's Recoveiy 
Manager (RMAN) using its Proxy Copy feature. The other is the 
SAP R/3 System SAPDBA utility through EMC's SAP-certified 
interface client: EMC Backlnt. 

Symmetrix Connect offers these features: 

• high speed backup throughput to tape media 

• Oracle database and tablespace-level online and offline 
backup capability, plus data file-level backup if using 
RMAN Proxy Copy 

» data file-level i-estore (plus disaster i-ecovery) capabilit}' 

• minimal impact on your local area network 

» minimal impact on the client (whose database is being 
backed up) 

o UNIX filesystem backup for all supported clients 

• Oracle filesystem backup for all supported clients 

• Windows NT support for Oracle Backup, Exchange Seiver 
Backup, SQL Server Backup, and filesystems 

• SAP Wi Symmetrix Connect support for Oracle databases 
on UNK clients database running EMC Backlnt 

« multiple simultaneous database support for UNIX clients 

• PowerPath interoperability'' 

• GUI client configuration and backup capability 

• enhanced GUI System Monitoring Support features 

If you are using a miiToring facilit}', Symmetrix Connect 
backups take advantage of three Symmetrix features to provide 
high performance cUitabase backup with minimal impact on 
your database server (host): 
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• Symmetrix Remote Data Facility (SRDF) 

• Symmetrix TimeFinder (or SMMpT") 

• Symmetrix Remote BCTV in an SRDF Configuration 

In addition, tlie multipath disk access feature is Symmetrix's 
ability to allow multiple (local and remote) hosts to I'ead and 
write data to and from the same disk at the same time. 

Note: Hierarcliical Storage Management (HSM) is not 
supported with EMC Data Manager Symmetrix 
Connect software. 



For more information on Synimeti-Lx Connect, refer to: 

• The EMC Data Manager Symmetrix Connect User Guide for 
information on using this feature with tlie EDM Oracle 
Application hiterface for UNIX clients and Filesystem Appli- 
cation for UNIX clients. 

• The following guides for information on Symmetrix 
Connect with the EDM-specific interfaces to NT filesystems 
and databases: 

- EMC Da ta Adanager Windows AT Backup Client 

- EMC Data Mariager Windows NT Oracle Backup Client 

- EMC Data Manager Windows NT SQL Sewer Backup 
Client 

- EjMC Data Manager Windoivs NT Excha nge Backup 
Client. 

• The EMC Data Manager Oracle Backup Client guide for 
information on using Symmetrix Connect witli RMAN Proxy 
Copy (on UNIX clients). 

• The EMC Data Manager EMC Backint guide for information 
on using Symmetrix Connect witli the SAP R/3 System's SAP 
Tools (on both UNIX and Windows NT clients). 



EDM Hardware 



You can purchase an EDM in several configurations (models) 
and witli various system upgrades. 

The server unit can be configured with multiple SBus cards; 
their use dej^ends on yovir SCSI peripheral and networking 
requirements. SBus board options include Ultra-SCSI 
(differential), EDM-Fibre (Fibre-Channel), ATM, Quad Ethernet, 
Fast Etliernet, Token Ring, and FDDL 



In addition to a Power Distribution Unit (PDU) and a server 
unit, most EDM cabinets contain a disk subsystem that stores 
catalogs and contains operating system and application 
software. 

If you have a SPARCserver lOOlE or Ultra Enterprise 4000 (or 
4500) unit, a Sun disk subsystem is provided for tlie storage of 
backup catalogs, EDM Baclaip software, Solstice, and other 
files. An Ultra Enterprise 3000 (or 3500) system contains six or 
more internal disk drives that function in a similar manner. 

The disk subsystem catalogs all files that were backed up by 
EDM. 'Fhe disk subsystem is required in netw'ork-only 
(non-Symmetrix) backup environments. 

For concepts on the use capacities of the various catalog disk 
subsystems, refer to "Magnetic Disk Capacity" on page 10-5. 



EDMs are equipped with tape library units (DLT, DTF, HITC, 
8mm) and/or optical libraiy units (EO or WORM) that provide 
secondary online storage and perform unattended backup of 
user data. Each library unit holds a robotics or picker system, 
one or more drives (tape or optical), and media that enables 
you to store from tens of gigabytes to tens of terabytes of data. 

Refer to EMC Data Manager Storage Devices for more 
i formation about suppcjited library units. 
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External Components in addition to the EDM cabinet(s) and any extei-nal libran? units, 

your EDM comes with the following hardware: 

• Remote Diagnostic Modem 

• Color System Console 

Installation of Symmetrix systems is handled separately. 



Remote Diagnostic Modem A remote diagnostic modem (RDM), external to the cabinet and 

equipped with RS-232 cable, enables dial-in. Tlie modem must 
be connected to a dedicated telephone line. 

The modem and tlic Remote System Monitoring (RSM) function 
enable the EDM to notify tlie EMC Customer Service Database 
about general system information and any problems with the 
EDM system. Tlie modem and RSM also enable remote-user 
dial-in by EMC personnel to queiy the EDM. 

The EMC Customer Service Database is the service management 
software that Customer Engineers, Customer Service 
Technicians, and Product Support Engineers use to log service 
activitV', track field sei-vice inventory, down load files, and to 
look up other important customer information. 



Color System Console The Sun system console has a color, high-resolution, bit- 

mapped display and includes a keyboard, and a three-button 
optical mouse. 

The color .sy.stem console uses the Common Desktop 
Environment (CDE) for displaying the EDM GUE It enables 
GUI-based system administration of the EDM as well as access 
to applications that run on net^^'ork accessible hosts. 
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EDM Software The EDM Backup software with dient/'server architecture 

supports Symmetrix Connect and Symmetrix Patli as well as 
standard network backups. The sen-'er software is located on 
the EDM unit. Client software is located on the EDM and on the 
other hosts within the neOA^ork architecture. 

For more irformation, refer to "Client/Server Architecture" on 
page 3-2. 



Software Components EDM software consists of tlie following components: 

• Backup — provides centralized backup and restore services 
for the server and clients on the network. 'Hie EDM's 
backup server software runs on the EDM server. The client 
software runs on the server as a local client and on each 
networked (remote) client. To understand netw^ork backup 
and restore, review Chapter 3 "Basic Backup and Restore 
Concepts," Chapter 5 "How Backup and Restore Work," and 
Chapter 6 "Database Backup and Restore." 

• Volume Management — provides integrated media and 
library management for the EDM server. The volume 
management softvtfare keeps track of all media that is 
known to the server, whether it is in a libraiy unit or an 
offline or offsite location. For an understanding of volume 
management, review Chapter 7 "Basic Volume Management 
Concepts,'' Chapter 8 "How Volume Management Works," 
and Chapter 9 "Media Duplication." 

• HSM (Hierarchical Storage Management) — is an option 
that is available with EDM network backups. 'Iliis option 
provides HSM for the EDM system, both for die loail server 
and for networked clients. For an understanding of HSM, 
review Part II, "Hierarchical Storage Management." 
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System Monitoring Support — enables Customer Service 
and/or system administrators to configure and receive 
notification of serious system problems that prevent 
successful completion of the backups or related issues and 
system status. Wlien configured with RSM soft^-are, notifi- 
cations can be sent to EMC's Customer Sendee Database 
system and to designated email recipients. SNMP traps can 
be generated and Tivoli event messages issued. Use the 
System Monitor Configuration GUI to configure it, and 
online Help to learn more about its features. 

Client — is available for a wide range of PC, Windows NT, 
and database clients. 



EDM Graphical User For network applications, use the EMC Data Manager graphical 

IntSrfaCS user interface (GUI) to install and configure both backup and 

HSM clients, manage media volumes, monitor libraiy units on 
the EDM, configure backups, restore data, monitor backup 
activity', and display reports. Also, use it to set up the migration 
of data if you have tlie HSM option. 

Note: 'Hie software for HSM must first i3e installed directly 
on tlie client. 

Context sensitive online Help is available throughout the EDM 
user interface. Online versions of hardcopy books are available 
through the EDM button in Online Help. 

Note: The name of the EDM (ser\'er) is displayed in the 
title bar of each EDM window. 

For Symmetrix Connect and Symmetrix Path, use the GUI to 
install clients, configure clients, manage media volumes, and 
monitor library units on the EDM. You can use the GUI to 
perform network restores and Symmetrix Path restore 
operations. You cannot use the GUI for Symmetrix Connect 
restores. 
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Starting the EDM GUI 



starting the EDM GUI Remotely 



To start tlie EDM GUI on the EDM sewer, log in to the EDM. 
(If you want to configure and manage backups, log in as root or 
enter su - f rom youi- user account. Ilie is required.) 

Then set your environment and enter the edm command; 

# setenv DISPLAY nodenameiQ .0 

# edm S 

From any EDM or client, you can remotely launch the EDM GUI 
from any other EDM and display it on any EDM or client. 

1 . Set your environment to designate the machine on which 
you want to display the EDM GUI. 

client! setenv DISPLAY nodenameiO .0 

2. Enter edmremote with the remote EDM name, and enter 
the root password when prompted. 

client# edmremo'te edm_name 

Please enter password for <root> on <edra name> 
Passv*ord: 

edmremote - Remote GUI launch complete on 
<edm_narae> . DISPLAY = nodename : 0 . 0 

Refer to the edmremote man page for variations. 
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Main Window 



Menu Bar 
Toolbar 

Browser 



Browser 
Overview 



"lou t;in acccs.s ihc loUowmg T.DM lunctions Injin ihc menu Ixir, 



tool bar, or a pop-Lip menu in the browser. 




Backup Client Install Wizard 




Backup Configuration Wizard 




Backup Activit)' Wizard 




Volume Management 




Backup Configuration 




Backup Report 




Restore 




System Monitor Configuration 




HSM Client Installation^ 




HSM Configuration 




Note: The HSM Client Installation and Configuration 



windows do not appear unless you have the HSM 
option installed on your EDM. 



The liDM Main windovA' provides a central location for viewing 
and managing clients and libraiy units connected to the EDM 
server, and for monitoring and reporting on backup activity. 

The main viewing area contains the browser and browser 
oveiview, as shown. 

L.>M..lll.il LM'.l"tj l.iij.j.r 



■ *istai 
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Backup Client install Wizard j— i click on this icon to install a backup client. The 

Backup Client Install Wizard leads you step by step 
— — ^ through die install process: 

Refer to EDM online help for more information about this 
wizard. 

When you complete the installation, a window opens and asks 
if you want to configure a simple backup. 



Backup Configuration Wizard .-•■,| The IBackup configuration wizard enables you to 

4^m « ^^""fi^ure a network, SymmetrLx l\ath, or S>'mmetrix 

" Connect backup of filesy.stems or a dalaba.se. lliis 
wizard supports database backups for Oracle, Informix, 
Exchange. SQL Server, lotus \otes, and Sybase, 'llie Backup 
(]onfigurati<jn Wizard leads you .step b\- step through the config- 
uration process. Refer to tT)M online help tor mc;re intbrmalion 
about this wizard. 

When you ccjmplete tlie configuration, backups can start, either 
automatically if you chocxse that option in the wizard, or 
manually using either the Backup Activitx' Wizard or the 
command line interface. 



Backup Activity Wizard The Backup Activity Wizard enables you to start new, 

j queued, or failed backups, stop running backups, or 
~— — J manage the backup queue. 

In the Wizard jianels you select a backup operation, select the 
objects that you want to operate on, choose backup options, 
and confirm your actions, 'llien from the Main window, you can 
monitor the progress of the backup operation tliat you initiated. 
(Refer to EDM online help for more information about this 
wizard.) 

Note: You must have root pri\ileges or l^e an EDM 

Backup Administrator to use the Backup Activity 
Wizard. 
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Volume Management j click on this \con to displax the Libra ly I 'nit Manager 

■d i windovv'. In this window. )-ou manage and monitor 
— media, library units, and dri\'e.s. ^bu can label media 
(\'C)lumes). t:ike an inventoiy of tapes or optical di.sks in a unit, 
find specific tapes or disks, create and save castomized senings 
in the media list, restart failed media duplications, and perform 
other related tjisks. (Refer to EDM Online Help for more 
information about these options.) 

Volume management also alerts you when operator intervention 
is needed. For example, if additional media is needed to 
complete a backup, a window appears tliat indicates the 
volume(s) that are needed to complete the opei-ation. For more 
information about volume management, refer to Chapter 7 
"Basic Volume Management Concepts," Chapter 8 "How Volume 
Management Works," and Chapter 9 "Media Duplication." 



E[>U(stBillUi) LibriiV Jnit Maiajei 




Buttons 
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Backup Configuration ^^^'^^ °" icon to display the Backup Configuration 

8" window. I'se it to \'iew backup schedules, configure 
~— clients for backups, assign media sets to backups and 
assign backup administrators to perform restricted tasks. 

You can also set backup schedules based on parameters that 
you specify for your site. This configuration process enables 
you to tailor the backup system to meet the needs of your 
organization. For an understanding of backup and restore, 
review Chapter 3 "Basic Backup and Restore Concepts," 
Chapter 5 "How Backup and Restore Work," and Chaplei- 6 
"Database Backup and Restore." 
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Backup Report 



I f——ni Click on this icon to display the Backup Report 

window, where you can execute reports on active and 
completed l^ackups. You can view reports on the local 

EDM, or participants of an EDM domain can view domain 

reports on other EDMs in the domain. 

This window enables you to create, modify, and sa\'e backup 
reports in several key areas, such as perl'ormancc within 
specified time periods, work items with ]50or performance, or 
failed w?ork items. 

^'ou can configure a report that filters on lime and date ranges, 
work item characteristics, backup states, tliroughput 
information, and backup le\-el. ^'ou can also designate tlie 
columns the report displays. 



■ 'V.iv. ll ii.'.l li'il.N! 
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Restore -f f-f I ^^^^^ on tliis icon, or enter edmrestore on the sei-ver 

jgp^ > command line, or enter edmcrestore on a client 
— 1 c(3mniund line t<j display the Restore window. Use it to 
restore data that the EDM has backed up. 

To simplify restoring files, catalogs of backed up files are 
maintained on disk. Using the restore program, you can browse 
on-line catalogs, mark files or entire directories for restore, and 
restore them to a selected client. For an understanding of 
restore, see "How Restore '^^C'orks" on page S-16. 
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System Monitor Configuration in the ci i, you can configure many RASD and RSM parameters. 

RASD creates various alerts that can be sent by email to a 
unique list of recipients, which includes Customer Service 
personnel and/or the system administrator, an SNMP trap or 
Tivoli Foundation Level event notification to a designated work 
station, or calls home to the EMC Customer Service Database 
system. The type of alert depends on the severity' of the 
problem, the alert recipients, the length of time tliat the 
problem persists. Functions that RASD monitors are scalable 
and configurable. RASD functionality enables monitoring of 
items such as available volumes using watemiarks, cleaning 
cartridges using watermarks, drives that need cleaning, 
unsatisfied volume requests, swap space and filesystems using 
watermarks, failed backups, client availability, patches and 
firmware revisions, failed duplications, read/write en'ors. etc. 

The System Monitor Configuration GLJl interface is part of the 
EDM Main window. Under the Main window, choose System 
Monitor > Configure... 
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Also part of the EDM RASD sofrw'are is die ability of Tivoli 
Foundation Level integration so that Tivoli customers can call 
the GUI from their framework package. Administrators can 
launch the liDM GUI from Tivoli, customize their management 
GUI to call the EDM GUI, provided that tlieir Tivoli Event 
Console (TEC) is a valid EDM backup client. You can learn 
more about RASD dirough the GUI online help. 



HSM Client Installation 



If you have the USM option, click on this icon to 
display tlie HSM Client histaliation window to make an 
lISM client (on which HSM softvvare was previously 
in.stalled through epjn.siall) visible and configuralile 
from the HSM (Configuration window. 
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HSM Configuration . if you have the llierarehical Storage Management 

I ^^^^^'^^ option, click on tliis icon to displa>- die I ISM 
——J ('onflguration \\ indow to set up stageable files) stem.s 
on the server and clients, 'lliis window enables you to set up 
the details of migrating file data out to optical disks or magnetic 
tapes, creating a much larger virtual filesystem. l or detailed 
inlbrmalion about IISM, re\-iew Part II. "Hierarchical Storage 
Management (IISM)," in this manual. 
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Hie EDM Software Reference provides you, the system 
administrator, with step-by-step instmctions for managing the 
EMC Data Manager (EDM) system witli or without tlie 
Hierarchical Storage Management (HSM) option. 

Tliis chapter outlines the procedures tliat you peiform regularly 
to manage your system. Topics in this chapter include: 

• Administering tlie System 

• Running Procedures Automatically via Cron 

• Backing Up Sen'er Database Files 
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Administering tiie System with an EMC Data Manager system, you sliould perform 
several tasks at the beginning of the day. 

Most repetitive tasks are set up to am automatically from root's 
crontab file. Tliis section briefly describes both manual and 
automatic tasks. 

If you have the HSM option, remember tliat even though HSM 
software can migrate files to and from staging media, tlie files 
must be backed up, whether they reside on the server's 
magnetic disks or on the staging media. As with any data 
storage solution, backups are a must. 

As a system administi-alor, you should perform the following 
tasks on a regular basis: 

□ Check daily to ensure an adequate supply of media is 
available in the library unir(s) for the next backxip and 
migration runs. 

□ Verify that at least one cleaning cartridge is available in the 
library unit. 

□ C^heck the Backup Report window in the EDM graphical 
user interface (GUI), or the Wstory report, to ensure that 
your daily backups (and duplications, if any) completed 
successfully. 

□ Read tlie daily message log file to review system 
activity'. 

□ Run and save the backup disaster report. 

□ With the I JSM Option, check compaction of staging and 
baseline volumes (weekly). 

Database/system administrator duties for Symmetrix Connect 
backup and restore activities are described in the EMC Data 
Manager Symmetrix Connect User Guide. 
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Checking Media Eveiy day you sliould make sure that enough media is available 

in the libraiy units to perform scheduled tasks such as the 
nightly backup and periodic staging runs. Always keep a supply 
of pre-labeled volumes in tlie libraiy unit. Also ensure that a 
cleaning cartridge resides in the library imit. Refer to Chapter 7 
"Basic Volume Management Concepts" for more information. 



Verifying Backup Completion Vou can check on completed backups at any time b> 

\iewing the Backup Report window in the EDM GL'l. ^s}! 

Access this w indow from die Main window by clicking o^^j 
^m this icon in tlie Main window tool bar. 

In the Backup Report window, you can \'iew and execute 
reports on the local l-DM or on a group of HD:V1s that are clearly 
defined as a Domain. The report can include backup attributes 
lor a specific work item such as its backup status, total 
throughput, total size of the backup, total files that w ere backed 
up, and others. For detailed information about the Backup 
Report window, click the Help button in die window. 

^'(ju can also run ebrejXJrt backup e\ery day, after the daily 
backup is sclieduled to complete, to \ erify that all of the 

scheduled backups completed. 

The following example lists all of the backups that have run 
since a specified date: 

# ebreport backup -since date 

The following example lists all of the backups that have run for 
a particular client since a specified date: 

# ebreport backup -client ciientname -since date 

Refer to "Backup Duplicate Reports" on page 16-12 and the 
ebreport man page for more information. 
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Reading the Daily Message Tlie error logging facility produces a log file on a daily basis 

File that reports system activity for the past 24 hours. Tliis log file is 

located in /Var/adm/epocli/daily. (See Chapter 15 "Message 
Logging" for more information.) If you have a mail facility', you 
can edit root's crontab file to mail tliis log file to the appropriate 
users. 

The portion of the crontab file that describes the daily log file 
follows: 

# Daily log 

i eptrunclog truncates /var/adm/epoch/dally to a one day slice. 

# eptrunclog can also mail the log to one or more specified users. 

# eptrunclog should not be run at the same time as epnewlog 

# to mail the log to different user (s) , replace "root" with the user list 

# to skip mailing the log, delete "root" from the command line 
00 7 * * * /usr/epoch/lib/eptrunclog "root" > /dev/null 2>&1 

By default, the trunc_daily_log script mails the log file to root. 
To send the log file to additional users, do the following: 

1. Log in as root. 

2. Open root's crontab file with the editor of your choice. 

3. Locate the line: 

00 7 * * * /usr/epoch/lib/eptrunclog "root" > 2>&1 

4. Add the names of the users to whom you want to send the 
log files. Separate user names with a space. For example: 

00 7 * * * /usr/epoch/lib/eptrunclog "root cbr" > 2>£l 

5. Save the file and exit from the editor. 
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Saving the EDM Backup At iJie completion of evejy backup, the /usr/epoch/EB/ 

Disaster Report config/'loca]_db_cleanup script automatically generates a 

MINIMAL Disaster Report. By default, this report is e-mailed to 
all EDM Backup administi-ators, appended to /usr/epocli/EB/ 
config/'disaster-report.log, and printed to tlie default system 
printer. 

CAUTION: It is essential that, for each backup, you 
save a hard or soft copy of the MINIMAL 
Disaster Report in a fireproof location, 
either offslte or in an onsite fireproof vault. 

This MINIMAL Disaster Report is a subset of the FULL Disaster 
Report generated by ebreport disaster. It provides essential 
information that you need to perform a disaster recoveiy on the 
server — a list of media volumes for tlie most recent 
LOCAL_I3ATABASE backup, the cunent EDM Backup 
configuration, the current Lilirary Manager configuration, copies 
of the key configuration-file settings, and information about 
baseline backups. 

This MINIMAL Disaster Report does not include backup client 
information. 

You should run tlie FULL Disaster Report once eveiy backup 
rotation and whenever significant system changes were made. 
The following example runs die FTJLL Disaster Report and 
redirects it to a file: 

# ebreport disaster > ~sysadinin/disreports/960917 

Refer to Chapter 19 for more inlbrmation on being prepared for 
a system disaster. See "Backup Disaster Reports" on page 16-19 
for a description of the FULL Disaster Report. 
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Check' Compaction of Staging in the HSM option, compaction is a collection process that, in 
and Baseline Volumes effect, frees up staging volumes and baseline volumes in a 

libraiy unit, which ensures a pool of available media. 

You can configure HSM softvv-are to compact staging volumes 
automatically. (See the emcompact line in root's crontab file.) 
If you use l:)ase]ine backup, you need to compact your baseline 
volumes manually. Note that only reusable media can be 
compacted automatically. Refer to "Compaction of Staging 
Media" on page 11-27 and "Compacting Baseline Media" on 
page 11-29 for details. 



Running Procedures You run most repetitive procedures automatically from root's 

Automatically ¥ia CrOn crontab me (refer to on page 2-7). The cron entries are placed 

in root's crontab file during configuration. If you do not use the 
autoconfiguration option, the configuration pi-ograms prompt 
you for crontab entries. 

Note: Adding new entries to the crontab file through the 
EDM GUI does not replace existing entries with tire 
same characteristics. You must remove existing 
entries from crontab manually. It is recommended 
you do this by running crontab -e as rcx3t. (Refer to 
the crontab(l) man page for more information.) 

You can also schedule a l^ackup in the crontab file within the 
Backup Configuration window of the EDM GUI. In the Schedule 
tab, you choose a work group for backup; select Schedule in 
CRON in the CRON Options section, and enter the time that the 
backup is to occur. You can also indicate whether you want to 
retiy a failed backup, or use new media for a backup. EDM 
places this information in the crontab file; the baclaip then runs 
automatically at the specified time, on a daily basis. 

For maximum efficiency and backup coverage, EDM Backup 
default settings back up the server first, followed by the 
network clients, and finally, the EDM Backup and Volume 
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Management databases. You can back up the server, several 
clients, and the seiver database all milhin a single backup 
template. 

The following entries are added during EDM Backup 
configuration: 



# Entries for EpochBackup end with this comment: #EPCebs 

# Invoke EpochBackup backup program #EPCebs 

00 18 * * * /usr/epoch/EB/bin/ebbackup default >/dev/null 2>&1 #EPCebs 

# Invoke EpochBackup catalog cleanup program #EPCebs 

00 1 * * * /usr/epoch/EB/bin/ebcatclean >/dev/null 2>&1 #EPCebs 

# Invoke EpochBackup catalog expiration program tEPCebs 

00 11 * * * /usr/epoch/EB/bin/ebexpire -expire -purge >/dev/null 2>&1 
tEPCebs 



The following table lists procedures that are often run from 
cron. Note that most crontab lines that are used to invoke 
procedures must explicitly set the full path. 



cron Procedures 



Frequency: For further information: 



Table 2-1 



Procedure: 



Run epnewlog to rotate, archive, or truncate Hourly 
EDM system logs, weekly 

Run emvck to check and coiTect staging volume Daily 
statistics (HSM only). 

I^un periodic staging (emjnasterd,pid line in root's Daily 
crontab (HSM only). 

Run emcompact to compact staging volumes Daily 
automatically (HSM only). 

]^un eptrunclog to truncate the daily message log Daily 
file and optionally, to mail a copy to specified 
users. 



and See "Itotating Error Logs" on page 13-8 and the 
epnewlog man page. 

Refer to the emvck man page and refer to the 
daily message log. 

See "filesystem Configuration and Mainte- 
nance" on page 11-3 for details. 

Refer to "Compaction of Staging Media" on 
page 11-27 for details. 

See the eptrunclog man page. 
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Table 2-1 


cron Procedures (Continued) 


Procedure: 


Frequency: For further information: 



Run epcleanup lo remove files that are no k 
needed. 

Run ebbackup to back up your server, EDM 
Bacloip clients, and EDM Migration clients. 

Run ebreport disaster once every rotation 

period to keep track of backup media. (A 
minimal disaster report is genenited automatically 
aftej' each backup.) This report should be stored 
in a safe place (on another system and on hard 
copy) For use in recovering from a disaster. 

Run ebreport history after evei-y backup 
session lo see which systems wei'e successfully 
backed up. 'fliis can be included in a short script 
which also sends mail to the user community. 

Run ebbackup -drain together with ebbackup 
-halt if you want to ensure that backup 
It a certain time, 



Run ebcatclean to delete incomplete backup 
catalogs that may have been created by failed 
backups, 

Run ebexpire to manage expiration of catalogs, 
media, saveset records, and incomplete backups. 

Run ebexpire -purge to delete expired catalogs, 
media, saveset records, and incomplete backups. 

Run ebexpire -partial to delete incomplete 
catalogs and backups. 

Run ebexpire -list_orphaiis to display a list of 
orphaned volumes. 

Run ebexpire -free_orphans to display the list 
of orphaned volumes and then deallocate them to 
make them available. 



Daily See the epcleanup man page. 



Daily Refer to "Backup Processing" on page 14-2, and 

the ebbackup man page. 



Daily Refer to "Baclcup Disaster Reports" on page 

16-19 and the ebreport man page. 



Daily Refer lo "Backup Duplicate Reports" on page 

16-12 and the ebreport man page. 



Daily See the ebbackup man page. 

Monthly See the ebcatclean man page. 

Weekly See the ebexpire man page. 

Weekly See the ebexpire man page. 

Weekly See the ebexpire man page. 

Varies See the ebexpire man page. 

Varies See tlie ebexpire man page. 
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Table 2-1 cron Procedures (Continued) 


Procedure: 


Frequency: For further information: 


Run emscheck to clear incomplete bit files Fro 
client stores (HSM only). 


m Daily 


See the emscheck man page. 


Run emsxmdel to recover bit files from the 
server's backup volumes. (HSM only). 


Daily 


See the emsundel man page. 


Run evmclean to clean tape drives. 


Varies 


See the evmclean man page. Also, refer to the 
tape drive's manufacturer for details regarding 
maintenance scheduling. 



Deleting Existing Entries in the Adding new entries to the cromab file tl-u'ough the EDM GUI 
crontab File does not replace existing entries for the same activities. You 

must remove existing entries from crontali manually. After 
creating new, equivalent entries through the GUI, it is 
recommended that you delete existing entries by amning the 
command crontab -e as root (refer to the crontab( 1 ) man page 
for more information). 

Note that the EDM GUI controls pre- and post-commands 
creation; thus, you do not have direct control over those 
extensions to tlie ebbackup command when you are using the 
GUI. The GUI does not allow you to configure complex or 
non-standard pre- and post- commands. If you want to use 
complex or non-standard pre- and post- commands, use the 
crontab -e command. 
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BSCkiny Up SorVBr A11 configuration, backup, and volume information resides in 

Database Files individual sender database files. EDM Backup and Volume 

Management each maintains its own information. Hie ser\'er 

database files consist of: 

• volume management database 

• backup catalogs 

• backup management files 

The LOCAL_DATABASE work item, which is created as part of 
server autoconfiguration, includes the patlinames of tlie server 
database files. It is essential that this work item is part of the 
nightly backup. The server database files are essential for 
performing a complete restore of die seiver and clients in the 
event of a disk failure. 

Always back up the EDM Backup databases on the server after 
you back up the clients. This is also the case even if you have 
no network clients, because the server is considered a "local'" 
client to EDM Backup. 

Database backups provide you with complete inlbrmation 
about both tlie seiver and client backups and shorten disaster 
recovery' time because they allow you to restore the database 
independently from the files that were already backed up. By 
default, the LOCAL_DATABASE work item is backed up last. 

If the LOCAL_DATABASE work item remains in the schedule for 
more than 24 hours without being run, it is forced to run 
immediately. Tliis is known as a "late" LOCAL_DATABASE 
backup. 

For more information about tlie backup and volume 
management files which make up the server database, refer to 
Appendix A "Directoiy Structure". Backup catalogs are 
described in "Cataloging of Backup Data" on page 3-11. 
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Tlie EDM Backup software automatiailly backs up computers 
throughout your network. It works with volume management 
softAvare, which manages storage media in robotic librar\' units. 

'Iliis chapter describes the basic concepts of backup configu- 
ration and operation. Its focus is on filesystem backup over tlie 
network. 

Tlie topics in tliis chapter include: 

• Client/'Server Architecture 

• Key Processing Concepts 

• Configuration Options 

• Reports and Logs 

• Manual Operations 

For information on database backup, see Chapter 6, "Database 
Backup and Restore". 

For overview information on EDM Symmetrix Connect backup 
and restore, refer to die EIVIC Data Manager Symmetrix Connect 
User Guide, die Oracle Backup Client guide, and die EMC 
Backint guide. 
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Client/Server Architecture Backup and restore software has a clienl/sei-ver architecture: 

• client software runs on the sen-er (the EDM) and on each 
client that you want to back up in your network 

• server software runs centrally on the EDM that also runs the 
volume management software 

Server software automatically administers backups of the data 
on clients tln-oughout your network and of datii on tlie EDM 
server itself. It does so according to general parameters shipped 
with tlie system and added when you first set up the system. 
You can change tliese backup parameters to meet die specific 
needs of your site. 

Remote client software, wliich is located on each client, receives 
instructions from the server, scans filesystems, and sends the 
backup data to the server. Local client software, which is 
located on the seiver, backs up the server data to the server's 
tape library unit. 

For level-9 incremental backups, tlie client software determines 
which files changed since the last full backup and backs up 
only those files. 

If you purchase the optional EDM Online Database Backup 
software, you can back up a database widiout shutting it down. 

Without the online option, the basic EDM Backup client 
software enables offline database backup by shutting down 
databases prior to backup. After database backups are finished, 
the client software puts the database back online. 

During die restore process, the client software receives the 
restored data and wiites it to the client disk. 

For a discussion of Client/Server processing, see "Client/Server 
I^rocessing Methods" on page 5-6. 
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Figure 3-1 
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Key Processing Concepts EDM Backup scheduling and processing is automatic and 
dynamic. Workloads are balanced for speedy and efficient 
backups every night wliile creating a manageable set of media 
for every few weeks' wortli of backups. 

The data you want to back up is specified in work items, llie 
data can be a filesystem, disk, or partition on a UNIX, NetWare, 
OS/2, or Windows NT platform or an Oracle, Sybase, Informix, 
or SAP R/3 database. (Refer to the EMC Data Manager Software 
Release A-otes for a current list of available clients.) 

Work items are collected into work groups. A backup schedule 
template specifies where to write your backups and how work 
items are to be scheduled for backup. You can create separate 
trails for full and incremental backups. Trails are grouped into 
traiJsets (media sets), which specify ti'ails for all of the backup 
levels that the schedule template uses. 

This section discusses the following concepts; 

• Scheduling 

• Nightly Backup Processing 

• Restore Processing 
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EDM Backup offers several ways to schedule backups: 

• Automatic Scheduling 

• Custom Scheduling 

• Command Line Scheduling 

• Backup Activity? Wizai'd 

If any client is unavailable for backup, EDM Backup continues 
to back up the other clients in the work group. EDM Backup 
automatically reschedules failed clients and balances the entire 
schedule. 



Automatic Scheduling Automatic scheduling of filesystem baclcups perfonns some 

number of iiill backups each day for the scheduled period. 
EDM Backup calculates its own schedule for performing full 
(level 0) and incremental (level 9) backups. With automatic 
scheduling you can also change the schedule to perform full 
backups only during weekends. Configure automatic scheduling 
in the EDM Backup Configuration window. 

Note: EDM-initiated database Isackups are automatically 
scheduled, too. But with database backups, no 
determination of full or incremental is made by the 
EDM backup scheduler. The EDM kicks off the 
database backups on the database client. Tlte 
backups are performed according to configuration 
on the client. See "Database Network Backup 
Overview" on page 6-7 for more information. 



Custom Scheduling Custom scheduling through the EDM Backup Configuration 

window enables you to perform filesystem backups other than 
the levels 0 and 9 backups that automatic scheduling provides. 
With custom scheduling, you explicitly specify the days and 
levels of backups for individual clients. 



Scheduling 
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Command Line Scheduling Command line scheduling enables you to enter command 

oveiTides to tlie schedule template configued by the previous 
methods. You can use command line scheduling to resume an 
inc(jmplete backup operation or to manually run a backup that 
is not cLin-ently scheduled with the automatic or custom 
methods. 



Backup Activity Wizard - ^^^i click this icon in tlie Main window toolbar of tlie EDM 

gggj Gl'l to access the Backup Activity Wizard. Tliis wizard 
— -i enables you to start new, queued, or failed backups, 
stop ainning backups, or manage the backup queue. 

Note: Yini must have root privileges or be an EDM 

i^acls'up Administrator to use the Backup Activity 
Wizard, 

Refer to EDM online help for more information about the 
Backup Activity Wiziuxl. 



EDM Backup Activity Wizard 

I he tl)M Uachup ActivilyVv'izarcl cnnbles you rostait 
ii-ickiips. slop running backups, or mojia.qr the backup 

WliBii perl(j|-iRiii(] a u»«kup operalioti, you: 

- select an operation 

- selsct QhjEcts to operate on 

- select backiip ofjtions 

- confirrri your actions 



Badtups are not ruining 
AcTLive; | \ QueiBd: | D | Failed, | 
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Concurrent Work Item Input Backup software enables you to gather backup data from many 

sources at once. The server can concurrently process multiple 
streams of data from numerous clients. 

For a typical client disk, tlie entire disk, with all its filesystems, 
is designated as a single backup tvork item. Each work item is 
backed up by a single client process, sending a single sti-eam of 
data to its corresponding server process. 

Software also considers various limits on backup processing, 
such as the total amount of backup data in die network, the 
total concurrent backup streams allowed to be sent to the seiver 
at any one time, and the total concurrent backup streams to be 
funneled togetlier to the storage media. 



Figure 3-2 Items of Data Specified For Backup 

Clients Filesystems Work Items Backup Data 

/ 1 

{ /usr f fini 

/home 



0- 



fin3: / 
y frnS: /usr 
V finS: /home , 




Large filesystems are designated as separate work items to 
prevent streams iTom being too long. (Special parameters 
prevent conflicting concurrent backups of data from the same 
disk.) 
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Because numerous work items can be scanned for backups 
separately, an oplimal subset of work items can be scheduled 
for a full liackup each night, while the rest of the work items 
receive incremental backups. Server software intelligently 
schedules cyclical full backups alcjng witli nightly incrementals. 
This is known as atitoschednHng. 

If you choose to autoconfigure your system, you have the 
following configuration: 

• Eveiy client is backed up according to a single backup 
schedule template, llie backup template lists the default 
work group. 

» Work items are created for each client and inserted into the 
default work group. 

• Backups are scheduled automatically, with each client 
receiving at least one full backup every two weeks (the 
rotation period) and receiving an incremental backup on all 
other nights. 

• Backups are written to one media set (trailsef) every night. 

• All of the data that is sent to the ti'ailset is written to a single 
media volume or series of volumes (a single traU). (A media 
volume is a labeled tape cartridge or one side of an 
erasable optical disk.) 

Software rotates full backups among tlie work items so that all 
work items receive a full backup at least once within a rotation 
period (the default is 14 days). 

Ever}' work item is scheduled for eitlier a full or incremental 
backup each niglit. To create the nightly liackup schedule, the 
server software considers not only the rotation period, but also 
actual backup results from previous nights. If all work items 
received a full backup in the rotation period, the software's load 
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balancing feature will schedule a new full backup for some 
work items, to continue to smooth out the backup work load 
for each night. 



Multiplexed Storage while numerous work items can be scanned for backups 

separately, it is possible to multiplex (funnel) the backup data 
together when writing to tlie storage media. 

Trails By default, the sen-er software sends all of the backup data in a 

single stream of data to a single backup drive, where the data is 
written to the backup volume. Whenever the volume fills, a 
new volume is automatically inserted into the drive. The next 
night, anotlier single stream of data is again written to the 
volume. At the start of the next rotation period, a new volume is 
automatically inserted in the drive. 

The single media volume or serial set of media volumes written 
to over the course of one rotation period is called a trail. 
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A complete set of full and incremental backups for a rotation 
period is called a media set (trailset). 

By default, the single trail also constitutes the trailset. But, you 
could write full and incrementals in xss'o separate streams to rwo 
separate trails (sets of media). You would need to use two 
dri\-cs for writing the backups concurrently. 

The combined set of full and incremental trails con.siitutes the 
trailset. Each trailset contains at least one full backup for each 
wijrk item (from \'ari(His nights in die rotation period) plus the 
incremental backups for e\'er\- other night in the rotation 
period. 



Multiple Trails in a Trailset 



Library Unit 



IWedia Set (Trailset) 
Trail: Fulls 





o 



Trail: Incrementals 
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Nightly Backup Processing Seiver software runs automatically every night to administer 

network-wide backups. Tlie software includes configuration 
parametei'S describing what data gets backed up from tlie 
magnetic disks of the server and any client computers, llie 
softw'are also maintains status infonnation about what data was 
or was not backed up recently. 

Soft^^-are refers to configurable backup shift guidelines for die 
maximum number of hours that the entire nightly backup has to 
stait backups. One guideline applies to weekdays, another to 
weekend shifts. 

Client software scans the filesysteras and databases (bodi 
filesystems and raw partitions) on the hosts and streams the 
data to the sei-ver. 

The sen-'er writes the data to tape library units attached to it 
through SCSI connections. 

Sei-ver software creates online catalogs of the backups to make 
it easy to restore whenever necessaiy. Notifications by email 
inform you of the status of your backups. You can run reports 
as well. 



Automatic Start A main liackup process is started nightly by cron from the root 

crontab file. (For more information, see "Running Procedures 
Automatically via Cron" on page 2-6.) This process consults the 
configuration parameters and status information, and then 
automatically schedules backups for each client's magnetic 
disks. 

The main process spawns separate processes to handle the 
loackup work for each client or portion of the client's data. Tlie 
individual server processes each send instnjctions to their corre- 
sponding client, and specifies which filesystems and files to 
back up. 
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Client Processing On each client computer (and on the server computer itself) the 

client software scans die local filesystems as directed. 

When prompted for a full backup (level 0), the client software 
copies data for all filesystems, directories, files, and databases 
specified for backup and streams the data to the sen'er. 

When prompted for an incremental backup (level 9) the client 
softNvare sends file data for only those files that have changed 
since the previous backup. (Unlike the UNIX dump level 9, 
each consecutive level 9 backup copies only files that have 
changed since the last level 9 backup.) 

Whether it is doing a full or incremental backup, the client 
softv>'ai-e always sends complete directory information, so that 
during the restore process, you can browse an accurate view of 
the directories as they were at the time of any backup. 



Backups of Changing Files You can continue to work during backups. As the backups are 

processing, the server software checks the backup directory 
information to find files that have changed during die backup. 
Any such files are backed up and checked again Wo more 
times that session. (Any files tliat continue to change both times 
will be backed up during the following backup session.) 



Storage of Backup Data As the server software receives die backup data, it writes all die 

data (from multiple clients) to one or more drives in the Library 
Unit. By default, it streams all of the data to a single backup 
drive, writing the backup data to the volume in that drive. 



Cataloging of Backup Data Backup software creates catalogs that keep track of filenames, 

file attributes, and locations of backup data. It copies the 
catalogs onto the media along with the backup data. When a 
backup completes, the software processes the catalogs and 
keeps them online so diat you can quickly retrieve the data. 
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To maintain sufficient magnetic disk space for backup catalogs, 
you'll need to expire the older catalogs after a fixed length of 
time, lite catalog expiration period must be at least one day 
longe]- than tv^-'O rotation periods. To determine catalog 
expiration, you must consider otlier system factors and user 
requirements for executing restores. Catalogs have depen- 
dencies on backups and other catalogs. Before you decide on 
an expiration schedule, refer to "Expiration of Backups and 
Catalogs'' on page 10-2 for more information. 



Restore Processing Anytime you need to restore a file from the backup media, you 

or your users can use the cdmcrestore command on the client 
to open tlie Restore window in the EDM GUI and display it on 
the client to browse and restore backed up data. Of course, you 
can also open the EDM Restore window directly from tlie EDM 
Main window on the seiver. 

The Restore window displays file listings derived from tlie 
online catalogs. You can brow^se through directories as tliey 
existed on each backup date, and you can browse back and 
forth among backup dates. 

When you have selected the files you want, you start tlie 
restore, line backup software locates all data, restores it to the 
client, and logs the restore activity to log files on die server and 
client computers. 
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Configuration Options As system administrator, you can configure backups for botli the 

server and clients centrally from the EDM Backup sen-'er by 
using the Backup Configuration Wizard and the Backup 
Configuration window in the EDjM GUI. You can restore the 
backed up files using the EDM Restore window. 

You can configure various aspects of your backups to meet 
your site's needs including your network's computers, librar>' 
units and drives, data, user profiles, and workshift scheduling 
demands. Use die EDM Backup Configuration Wvzard to set tlie 
parameters within the server's backup configuration file 
(eb.cfg). Use the Backup Configuration window to customize 
those settings, if necessary. For a description of the fields in tlie 
eb.cfg file, see Appendix B "EDM 13ackup Configuration File". 



Key Configuration Options Adjusting the configuration is, for the most part, optional. The 

configuration file is shipped with standard default values that 
are ready to run and are generally suitalile for most sites. 

Your only required configuration task is to install clients. In 
essence, all you need to do is to specify on the EDM server: 
Which client computers should be backed up? 

With clients installed, you can optionally configure these key 
aspects of how automated backup processing proceeds: 

• Wyat data on each client do you want to back up? 

• Wjen should backups run? 

• W-'here is backup data written? 
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Which Clients to Back Up? Use tlie EDM Backup Client Install Wizard on the sen'er to 

specify which client computers to back up. Hie Wizard leads 
you through a process where you select the clients from a list 
and install the software from the server over die network to the 
clients, as shown in Figure 3-5. 

Note: For PC clients you must first install the client 

software directly on the PC system as described in 
tlie appropriate user guide, llien use the Install 
Wizard, so that the EDM sen-er recognizes the 
client- 



Figure 3-5 Installing Client Software 



EDM Backup Server 



PC Client Software 




Network 



Instellation Options The EDM Backup Client histall lets you change various instal- 

lation defaults before you actually install new clients. Tliis is 
especially helpful for distinctive client platfonns. 

Installation options include changing accounts and directories 
for tlie client software and communication timeouts. 
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What Data is Backed Up on Each The specification of backup work for eacli client consists of one 
Client? or more work items. Tiie work item description or directive 

specifies filesystems, directories, files, and databases that are 
included and excluded from backup. Tlie work item directive is 
an expanded version of a UNIX And statement called a 
findxcpio statement. For more information, see Appendix D 
"findxcpio Directives" . 

Use the Backup Configuration Wizard to specif^' the data you 
want to back up. Then you can use the Backup Configuration 
window to edit single work items. 



When are Backups Scheduled? The general parameters for backup scheduling are handled 

within a backup schedule template. The schedule template 
provides parameters that the autoscheduling function uses. It 
ties them together with the m'ork items to be backed up and the 
media set (trailset) to be written to. Use the Backup Configu- 
ration Wizard to set these values. 

Rotation Period Trade-offs The rotation period and the various oflier scheduling param- 

eters are specified in the schedule template. The rotation period 
specifies a value that is actually used for two purposes: 

• Schedule rotation 

• Media rotation 

The schedule rotation is the fact that tlie software must perform 
a full backup on each filesystem work item covered by the 
template during tliis period. 

The media rotation is the fact that the software appends each 
nightly backup to the current volume during this period; at the 
start of a new rotation period, a new volume is started. 

The most common rotation periods are 7 days, 14 days (tlie 
defauk), or 28 djiys. A key consideration in determining the 
rotation period is that it is faster to write incremental backups 
than full backups, and incremental backups use up much less 
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storage media. But because it is faster to restore files from a full 
backup tlian from a series of individual incremental backups, 
you might want to specify shorter rotation periods for data that 
changes frequently. If your data changes less frequently, you 
might want to specify a longer rotation period. 

Assigned Woi* Groups Work items are grouped into one or more work groups, whose 

backups are coordinated by one or more backup schedule 
templates. 

By default, all server work items are assigned to a single work 
group named "default server work group." All additional client 
work items are assigned to a single work group named "default 
work group," and both work groups are assigned to a single 
schedule template named "default." 

All client backup work can be coordinated by one schedule 
template, but if some client backups need to occur more or less 
often you can assign some of the work to a separate template 
and specify different rotation periods for each template, lliis 
will write the data for groups of clients to separate media. 



Where is Backup Data Written? The primar)- reason for choosing a ceitain scheduling option 

may have more to do witli the resulting use of media. For 
example, multiple work groups, schedule templates, and media 
sets (trailsets) are useful for organizing a site for accounting 
purposes; by separating the media to which the data is written, 
you can charge each group for the media that tlie group uses. 

The schedule template names its coiresponding trailset. By 
default, all of tlie data is written to a single trailset. Tlierefore, 
you can create completely separate sets of backups for work 
groups by creating separate schedule templates and trailsets for 
different work groups. 



Use of Additional Backup Schedule 
Templates 
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And, as is mentioned earlier, you can create separate trails for 
full and incremental backups without editing the schedule 
template: you just edit the trailset to create a second named trail 
to receive the data from your full backups. 

Note: .Moving backup media offsite before its rotation 

period ends causes the liackup that 'rt ould use that 
media to fail. You can a\x)id a failed backup by 
using new media for the next backup. You 
configure the u.se of new media in the Backup 
Configuration window of the EDM GUI. Select 
.Advanced f)ptions in ilie Schedule Tab. In the 
Schedule Options window that appears, select Use 
New .Media When Current fiiackup medial Is 
Offsite. 

Alternate Trailsets You can schedule two complete sets of backups on alternate 

nights and store one set of media offsite. Tills doubles the 
number of full backups; one full backup is written to each 
trailset. 

In tlie EDM Backup Configuration window, you can create two 
complete sets of full and incremental backups that are written to 
on alternate nights. To configure two alternate sets of backups, 
you use a single schedule template, but in that template, you 
specify an alteniate trailset in addition to the primary one. 

The template writes to the primaiy trailset the first night of the 
rotation period and to the alternate trailset the next night, and 
so on. Twice as many full l3ackiips are run. In addition, there is 
more incremental data, because, instead of backing up files tliat 
changed in the past day, each incremental backs up files that 
changed in the past two days — since the previous backup to 
the same trailset. 

Custom Schedules In the Backup Configuration window of the EDM GUI, you can 

create separate trails for full explicit incremental backup levels 
(1-8). You create a custom schedule within a template and edit 
the trailset to create various named trails for one or more levels 
from 1-8. 
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In a schedule template, you can override autoscheduling and 
custom-schedule backups of particular levels on particular days 
for certain work groups. This should be done as an exception 
rather than tlie rule, as you are bypassing the software's 
autoscheduling intelligence and its benefits. 

But you can do this just for special data so that you can be 
certain that it gets backed up on a set date, so that you can 
specify- one or more explicit incremental backup levels (levels 
1-8) as well as levels 0 and 9, and so tliat you can write that 
data to a separate ti'ail. 

Media Duplication Media Duplication allows you to create a duplicate set of 

backup media automatically after each backup session. 

After you configure media duplication in the EDM Backup 
Configuration Wizard, tlie duplication of a set of backup media 
occurs automatically alter each backup session. This 
background activity starts after nightly backups complete. 

For a complete description, see Chapter 9 "Media Duplication." 



Other Configuration Options with automatic backups configured, you can also use the EDM 
Backup Configuration window to configure optionally the 
following otlier aspects of the backup and restore software: 

• processing of concurrent backups 

• identifying individuals who can configure automatic 
backups, run backups manually, and run restores 

• detennining the period of time that backup catalogs and 
data are kept before expiration 

• using new media when current backup media is offsite 
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How are Backups Processed? More than one backup process can run concun-ently on the 

server and client and be written to one or more backup drives. 
When extensively tailoring your configuration, you might 
decide to tune tlie preset limits on concurrent processing on the 
server, clients, and to the backup drives. 

You can limit these factors affecting backup and netvv-ork 
performance: 

• maximum number of work items the server can back up at 
the same time 

• maximum number of work items each client can back up at 
the same time 

• maximum number of work items to concurrently write to all 
trails for each media type 

• maximum number of work items to concurrently write to 
each particular trail (overridden if maximum for that media 
Wpe has been reached) 

• maximum amount of backup data in the netss'ork 



Permissions and User NIodes You can configure backup to recognize usernames for accounts 

on your neUvork as a backup administrator or a various class of 
restore users. (Keep the usernames to eight bytes or less.) 

You can configure EDM l^ackup to recognize your username as 
a backup adminisQ-ator, so that you can am the EDM I^ackup 
Configuration window. This also enables you to mn backups 
(ebbackup) manually from the server under your username. 

As backup administrator, you have permission to run restore 
with full permissions as system administrator from the server or 
any client computer. You can use the EDM Restore window to 
browse tlie backups of any client and change the destination 
client for the restore. 



Backup Administrator 



Administrator Restores 
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Client User Restore Modes For each client, you c^n authorize users to use restore with 

various levels of permissions. 

You can configure tliese in the EDM Backup Configuration 
window: 

• self-sendee restore users (who only can restore their own 
files on a single client). 

» cross-client restore users (who can restore their own files 
over to another specified client). 

• root-permission restore users (who can restore any files for 
a single client). 



Catalogs and Backup SavesetS The EDM Backup software creates one backup saveset for each 

work item every time it backs up the work item. 

The following comprises each backup saveset: 

• backup data: a copy of each client's backup data on the 
storage media. 

» backup catalog: an online listing of the names and 

atti-ibutes of each directoiy and file in the work item at tlie 
lime of the backup and the location of backup data for each 
file that was backed up. Backup processes this catalog after 
the backup and uses it when needed to restore data. 

• saveset records: contain information about an entire backup; 
for example, its start time and tlie trails that the backup 
program uses to write the backup data. 

Expiration policies for backup data, online catalogs, and online 
saveset records are defined for tlie various backup levels. By 
defeult, full backups are kept for one year and incremental 
backups for three months. 

You can configure how long to keep backup data (on the 
backup media) before expiring it so diat the media can be 
reused. 
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Yoii am also configure earlier expiration of tlie online catalogs 
that reference the backup media; you would do this to maintain 
magnetic disk space on your server, while keeping backup data 
longer, just in case it is needed. Catalogs take up a lot of 
magnetic disk space. See Chapter 10 "Magnetic Disk Concepts" 
for more information. 

The backup sofrvN^are needs the saveset records for as long as 
you keep the backup data. Saveset records are small relative to 
the catalogs. With the saveset records online, you can use tlie 
ebimport command if it is necessary to recreate an online 
catalog for a backup. 



Backup software maintains logs of aU activit)% mails notifications 
about backup processing, and provides various reports to aid 
you in monitoring the status of backups. 

Backup software maintains logs for backups and restores on 
l")otii tlie l^ackup server and on each client. It also maintains, on 
the sei-ver, a log that details the backup activities and cataloging 
operations for each backup template. 

EDM Backup automatically sends email notifications about 
backups that are in progress, that have completed, or failed. 
You can modify the management of mail notifications and log 
files in the Backup Configuration window of the EDM GUI. 

Refer to Chapter 15 "Message Logging" and Chapter 16 
"Backup Reports and Log Files" for details. 
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Reporting in tlie EDM OUI You ran monitor active backup processes and execute reports 

in the EDM GUI. 

During a backup, an object in the Main window such as tlie 
EDM server, a client, or a work item appears as an active 
process, .successfully backed up, in the backup queue, or failed 
to complete successfully. Current backup throughput also 
appears for a backup in progress. 

I'pon completion of a backup, you can then configure, save, 
and print backup reports on specific areas of importance such 
as failed work items or work items with poor performance. 




Click on this icon in the Main window toolbar to 
access die backup report module. 



I'oi- more information about active backup reporting, refer to 
EDM online help, "Backup Report Overview." 



Manual Operations Much of the backup operation runs automatically, but you can 

use certain manual operational and reporting commands at the 
command line or set them to run automatically from the root 
crontab file. Refer to Chapter 18 for a list of man pages that are 
available for backup and restore. 



EDM Software Reference 




EDM port control allows the EDM to communicate witli clients 
on the other side of a firewall. Port control is available for use 
with UMX and NT filesystem backups and with UNIX database 
backups. 

This chapter contains the following sections: 

• Understanding Port Control 

• What is a Firewall? 

• Port Control Checklist 

• Setting Up tlie Firewall for Port Control 

• Enabling Port Control on the EDM 

• Installing Port Control on the EDM Client(s) 

• Making Changes to Port Control 
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Port conti-ol allows you to control the TCP ports used by the 
EDM to communicate witli the clients. It also makes network 
analysis and auditing of EDM network activity' easier. It also 
allows you to take advantage of the router's abilit)' to prioritize 
packets. 

The discussion in this chapter is limited to how port control 
allows EDM TCP port usage to behave in a predictable manner 
so that firewall rules can be implemented. A firewall restiicts 
access between networks based on rules set by the local 
firewall administrator. 



EDM port control allows EDM TCP port usage to behave in a 
pi-edictable manner so that firewall ailes may be written to 
allow the EDM to communicate witli EDM clients on tlie other 
side of the firewall. 

The port control feature is available for use with UNIX and NT 
filesystem backups and with UNIX database backups. It gives 
you the option to control the TCP ports used by the EDM. Port 
control functionalit}' allows you to control TCP port usage so 
that you can: 

• Back up and restore UNIX and NT filesystems and UNIX 
databases in a firewall environment 

• Analyze and audit of EDM network activity 

» Take advantage of tlie router's ability to prioritize packets 
across tlie network, based on your own requirements 

EDM port control addresses only a portion of a complete 
security solution. Wlien properly configured, it eliminates 
EDM's dependency upon the backup clients' portmapper. Port 
control must be coordinated between an EDM and all clients 
that are expected lo use it. 
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Understanding Port Control By default, poit conti-oi is disabled on the EDM. To enable port 

control on the EDM seiver use eb_server_config without the - 
D option. You can configure an EDM to liave some clients using 
port control and some clients not using port conti-ol. To enable 
port control for selected client(s) use the Backup Configuration 
Wizard in the GUI, or the eb_client_mstall command with the 
-portcontrol option. 

Enabling port control is an easy procedure wlien implemented 
coiTectly at the time of server installation or update. Discuss 
your firewall policies widi the EMC service personnel who 
install your EDM. To adjust the settings after installation, you 
must use the portservices CL! to change port values, rerun 
eb_server.conlig, and reinstall all participating clients (see the 
portservices man page.). Contact Customer Service for assis- 
tance. 



Installing and Updating Client(s) installing, updating, and operating an EDM port control enabled 

client through a firewall has the same network requirements as 
other EDM clients, such as network name resolution. Port 
control allows normal operations to take place in definable tcp 
port ranges. 

Installing and updating a UNIX EDM client requires eithei- UNIX 
rsh or UNIX rexec accessibility from the EDM to the client and 
the ability to ping the EDM from the client. Tliese protocols are 
not usually permitted by firewalls and will need to be allowed 
during the installation or update. 
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Please note the following restrictions (see Table 4-1 on page 4-6 
for default port definitions): 
» Port control is not a backward-compatible feature, dierefore 
it requires EDM clients to be updated to EDM 4.5 versions. 
It supports most versions of UNIX and NT clients (but not 
Pyramid, Sequent, NCR, SCO and Alpha NT), 
e Network database backups require a return connection 
through the firewall from tlie client. 

• In client-initiated backups, ports have to be open from the 
client to the EDM. 

• EMC does not recommend by-passing firewall policies by 
bridging the DMZ and trusted network with the Symmetrix. 
Therefore, if you want to use port conti'ol with EDM 
Symmetrix Path or EDM Symmetrix Connect, you should 
discuss this carefully with EDM customer service and the 
local firewall administrator before implementing. 
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What is a Firewall? a firewall is a combination of hardware and software applica- 

tions used to create a gateway and provide controlled access 
from one network to anotlier. By reviewing all ti'affic and selec- 
tively allowing or disallowing data to pass, the fij'ewall protects 
the internal network from unwanted external intrusions. 

A firewall enforces network policy regarding the restriction of 
access Liased upon rules set by the local firewall administrator. 



EDM Firewall Assumptions 



FDM port control a.ssumes that the Perimeter Network Zone is 
separated from the EDM hy an internal firewall and that it is 
reasonabl) secure. If the FD.Vl is in the trusted zone, port 
control allo-^'s it to work within the firewall rules such that the 
FDM can perform a backup of a client in the Perimeter Zone. 
I'ort control can also he set up so that the clients in the 
perimeter zcjne can initiate backups. 



Ser\er 



1itnt2j 
Perimeter Zone 



For normal backup and restore operations, the firewall between 
the o-usted zone and tlie perimeter zone must be opened to 
allow TCP communication. Tlie scope of the opening depends 
on your company policies. 

The following are baseline assumptions needed for using EDM 
port control to backup and restore UNIX and NT filesystems 
and UNIX databases through a firewall; 
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EDM port control: 

• Assumes an IP filtering-capable firewall (which most 
firewalls are). 

• Uses the TCP protocol. (Use of UDP is not requLred and 
ICMP/SNMP are used by RASD for non critical functions.) 

• Exists so that rules can be written for a firewall that allow 
the EDM to interact witli EDM clients via TCP. Include the 
local firewall administrator in the process of defining ports. 

• Allows mles to be created within routers to prioritize 
packets. 



Default Port and Port Range Definitions 



UNIX Filesystem Bacln.jp and 
Restore 

UNIX Database Backup and 
K est ore 

UNIX Client Initialed 
Hlesystem Restore 

with GUI Display 



UNIX Client initiated Datai^ase 
Baclvup and Restore 

Windows NT Filesystem 
Baclcup and Restore 



From Server From Client 

to Client to Server 

8000:8250 — 

8000:8250 5600 

8000:8250 8000:8250 

XI] ports — 
(6000:6063) 

8000:8250 5600 

3895 — 



If you are using UNIX portmapper, you need to open tcp 
port 111 along witli 8000:8250. 
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Installing and updating EDM clients though a firewall 
requires the firewall to be open temporarily. Tliese ports 
may then be closed after installation/update of EDM 

cHent(s). 

Some firewalls understand these protocols and allow them 
to be generically specified to take care of the details. 
For those that do not, see Table 4-2: 



TCP Connections for Client installation and Update 



From The EDM From the Client 
to the Client to the EDM 



UNIX RSH from 
tlie EDM to the 
client 

UNIX REXEC 
from the EDM to 
the client 



I CF connections on 
privileged ports less timn 



non- privileged ports greatei 
than 1024, but usually 
greatei- tiian 5K, up to 65K 



Note that the UNIX REXEC protocol passes the password, in this 
case the root password for the client, unenciypied. For this 
reason, the local firewall adminisD-ator might choose to allow 
the UNIX RSH protocol and temporarily place a .rhosts file in 
the root directory on the UNIX client. 
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F'irewalls control connections. Once connections are estab- 
lished, data can flow bi-directionally. IP firewalls need to know 
about protocol, source address/ port and destination 
address/port. Tlie side of the firewall the connection i-equest 
originates from (DM2 or Internal Network) impacts required 
ports. 

Firewalls execute rules in order, looking for the first match. 
Some typical rules are: 

• Allow tcp source <edm> any destination <clienl> 8000:8250 

• Allow/drop/reject matching request, 
allow - like router, forward packets, 
drop - silently drop packets (timeout). 
reject - notify originator iconnection refused). 

• Protocols are usually TCP, UDP, ICMP 

• Source (from) what address range/port range. 

• Destination (to) what address range/port range. 

• Source and Destination are specified as universal addresses: 

<systeiTi name or ip>:<port range> 

Examples: 

myedra. customer .com: 8 000-8250 
193. 45.5.25:8000-8250 
193.45.5.0:8000-8250 
193.45.5.24:6000 
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Sample Firewall Configurations The following examples are provided for the local firewall 
administrator. These examples assume that the EDM is 
123.456.78.155 and the EDM client is 123.456.78.170. 

Basic Port Range Example To accept TCP connections from the EDM to a client within the 

defined port range: 

allow tcp source 123.456.78.155 any destination 123.456.78.170 8000:8250 

This allows any TCP port on the EDM (123.456.78.155) to 
connect to TCP pons 8000 tlirough 8250 on the client 
(123.456.78.170). 

NT Client Example To back up a Windows NT filesystem client, you must allow 

port 3895 on tlie NT client to accept TCP connections from the 
EDM: 

allow tcp source 123.456.78.155 any destination 123.456.78.170 3895 

This allows any TCP port on tlie EDM (123.456.78.155) to 
connect to TCP port 3895 on the client (123.456.78.170). 

Database Example To back up a UNIX database client, you must allow port 5600 

on the EDM to accept TCP connections from the client: 

allow tcp source 123.456.78.170 any destination 123.456.78.155 5600 

Tills allows any TCP port on the client (123.456.78.170) to 
connect to port 5600 on tlie EDM (123.456.78.155). 
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Port Control 



Port Control ChOCkliSt Before you begin to enable and configure port control, make 

tlie decisions in the Port Control Checklist. Tlie local firewall 
administrator should participate in this process. These decisions 
will be used to construct firewall mles and to configure the 
EDM and participating clients. 

It is important to do it correctly the first time. 

To change it later will requii'e the use of the portservices 

command line to make changes to the EDM server and then add 
the changes to the client(s) in order to keep them synclironized. 
(See "Making Changes to Port Control" on page 4-20.) 



Table 4-3 Port Control Checklist 



Decisions to Make 


Record Decision and 
Needed Action 


□ Name of EDM for port conti'ol. (Must be at least EDM 4.5.0) 




□ Decide which EDM clients and/or subnets will be accessed through the 
firewall. (Must be versions released with EDM 4.5.0 or greater.) 




□ Decide if the default port Kinge 8000:8250 is appropriate or if another 
port range is preferred. 




□ Decide if you want to use client-initiated backups for any client. If you 
do, you must be prepared to open the port range from the EDM client in 
the DMZ to tlie EDM server. See Table 4-1 on page 4-6 for details. 




□ Note that a low TCP session timeout value could result in failure of 
mover-aware backups and possibly restores. Either ina-ease the timeout 
value or only do non-mover backups through the firewall. 
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Port Control Checklist 



Table 4-3 Port Control Checklist (Continued) 



Decisions to Make 


Record Decision and 
Needed Action 


□ Decide if you will be using the UNIX portmapper on tlie client (the 
default) or the EDM poitsei-vices file. 

— Using the UNIX portiTiHpper is consei'V'titive, but less secure Hi is is 
tlie default, and requires that 'I'CI^ port 1 1 1 must be open through 
the firewall. 

- We recommend using the EDM poitservices file. This is more secure 
since you no longer open port 11], but get the port numbers from 
local files on die sender and die client. Clliere is a risk that services 
might not be able to be contacted ii" die configuration becomes 
unsynchronized by making changes on only one side). 




□ Decide if UNIX, database backups will be performed. If so, the firewall 
must allow port 5600 to be open from the client in the DMZ to the EDM 
in die trusted zone. See Table 4-1 on page 4-6 for details. 




□ Decide if NT filesystem backups will be performed. If so, port 3895 must 
be open from die EDM to the NT client in addition to the port range. See 
Table 4-1 on page 4-6 for details. 




□ Decide how you want to install UNIX client(s). Select either EDM 
Transfer Protocol or Remote Shell. Determine TCP port settings. See 
"TCP Connections for Client Installation and Update" on page 4-7, for 
more information. 




□ Decide if Symmetrix Padi or Symmetrix Connect backups will be 
performed. 

EMC does not recommend by-passing firewall policies by bridging the 
DMZ and trusted network with the Symmetrix. llierefore, if you want to 
use port control with EDM Symmetrix Padi or EDM Symmetrix Connect, 
you should discuss diis carefully widi EDM customer service and the 
local firewall administrator i^efore implementing. 
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Some optional features may not work if UDP and ICMP 
protocols are not allowed on the firewall, such as Il,\SD client 
pings and SNMP alerts. 

Note: There are 220 reusable ports per client. Database 
backup work items require 3 ports each plus 1 for 
each stream. Filesystem backup work items on the 
client use 5 ports per work item. 

After you complete this checklist, proceed with the following: 

« Setting Dp tlie Firewall for Port Control 

» Enabling Port Control on the EDM 

• Installing Port Control on the liDM C^lient(s) 



After you understand the issues involved in using port control 
with your EDM, and have completed tlie "Port Control 
Checklist" on page 4-10, have the local firewall administrator 
make all of the firewall adjustments before you configure tlie 
server to enable port control. 



Enabling Port Oontrol on You must configure the EDM seiver before you install and 
the ED^ configure EDM clients. At tliat time, you will push the definition 

files out to the client(s) to enable port control. 

While it is possible to make some clianges later, it is much 
easier to activate port control when you configure the EI3M for 
the first time. See "Making Changes to Port Control" on page 
4-20 for several examples of changes, llierefore, be sure to 
complete the "Port Control Checklist" on page 4-10 befoi-e 
configuring the EDM. 

To configure tlie EDM, run eb_server_conftg without the -D 
option. You must answer yes to activate port control. You only 
need to do this once. Port control will remain enabled when 
you run eb_server_coiilig again. 



Setting Up the Firewall for 
Port Control 
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Enabling Port Control on the EDM 

After logging in as root on die EDM server, enter': 

# eb_server_conf ig 

Do you wish to enable port control on the server? <y/n>[ n] : y 

Port Control Information: 

Low Port: 8000 

High Port: 8250 

Lookup Method: "portmapper" 

Enter the low port number for port control: 

(or just press return to accept the default value in square brackets) 
[ 8000] : 

Enter the high port number for port control: 

{or just press return to accept the default value in square brackets) 
[ 8250) : 

You have the following choices for Lookup Methods: 

1) Portmapper 

2) EDM port services file 

(or just press return to accept the default value in square brackets) 
[ 1] : 2 

Port Control files successfully installed on the EDM server. 

At this point, port control is enabled on the EDM seiner and you 
can enable port contr-ol on EDM client(s) when you install them. 
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Port Control 



Portservices Files Portsenices files are created in the format edm services.xxxx 

by the portservices command in the server's 
/iisr/epoch/etc/csc directoiy. The esc directoiy remains empty- 
until port conti-ol is enabled. (See the portservices man page for 
details.) 

The files specify which ports an EDM server uses to commu- 
nicate with its clients and other EDM servers. The presence of 
these files indicates tliat port control is configured. 

He following examples assume that: 

• edm] is tlie EDM server and the local client. 

• client! and client2 are EDM clients. 

• .clientl_template contains uncommitted changes for clientl. 

-rw-r— r-- 1 root other 816 Jan 7 16:40 edm_services . clientl 

-rw-rw-rw- 1 root root 824 Jan 9 16:39 edm__services . clientl^template 

-rw-rw-rw- 1 root other 812 Dec 20 16:20 edm_services . default 

-rw-rw-rw- 1 root other 816 Jan 9 16:40 edin_services . localhost 

-rw-r— r-- 1 root other 812 Jan 10 09:42 edm_services . client2 

Irwxrwxrwx 1 root other 22 Dec 20 16 : 34 edin_services . edml -> edm services . localhost 
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Enabling Port Control on the EDM 



Note tlie file extensions in the examples. 

1 . The .default file is cloned to create the .clientl and the 
.client2 files. 

2. These arc then pushed out to client! and client 2 to enable 
pon conliol. 'lliey are stored on clientl and client2 as the 
.localhost file and on ednil as the .client] and client2 files. 

3. The .localho.st file on cdml is pushed to clientl and clicnt2 
and named the .edml file. 



ecltn J 

ed m_sen1ces . localhost 
^° /■-"■"• edm_sen'ices.default 



'i edm_ser\1ceb.client 1 
"" edm_sen ices.client2 



client] 

ed m_sen'ices. edml 
edm_SLr\'ices. localhost 



edm_ser\'i ces. edml 
edm_ser\ i ces .local host 
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Port Control 



lb change the configuration of client!: 

1. Use the portservices command (see the portservices man 
page) to create an edm_services.clientl_template file with 
uncommitted changes on the ser\cr. 

2. Reinstall clienti , selecting yes in the port control window of 
the Backup Client Install Wizard. 

a. This copies the .client l_template file to client] and 
o\'envrites the .localhost file. 

b. If that is successful, it will then rename the 
.clientl_,template file to .clienti on the server and 
ovens rite the existing file. 



edm_sen 
edm_sen 
edm_ser^ 
edm_sen 
edm_ser^ 



s. localhost 
s.delault 
s.clicntl. - ^® 

% 

s, clienti \< 
s.clientl_lemplate 



clienti 
edm_sen ices.edml 
edm_seiTices.localho.st 

7 



clienl2 

edm_sen'i ces . ed m 1 
edm_.ser\'i ces locallujst 



Note: If there is a .cljent_template file, it contains 
mitted clianges. 
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Enabling Port Control on the EDM 



.lOCalhOSt File On botli the server and the client, the .localhost file contains 

settings for the local system. 

To view tliese settings, on either the server or the client, enter: 
# portservices -disp localhost 

The following output appears: 

Port Configuration from file <edin_services . localhost> 

8000 

8250 
31 

8000:8030 (31) 
8031:8250 (220) 
SO_REUSEADDR | SO_LINGER_10 
EDM port services file 
Ident Offset Comment 



emrpcd 


RPC 


390000 


D 


staging daemon (HSM) 


vmdaemon 


RFC 


390001 


1 




einsd_l 


RPC 


390003 


3 


migration daemon (HSM) 


emsd_2 


RPC 


390004 


4 


m.igration daemon (HSM) 


ebfsd 


RPC 


390007 


7 


ebfs daemon 


07dbapicl 


RPC 


390008 


8 


EB Database API Daem.on 


hsmd 


RPC 


390009 




HSM API Daemon 


epcommd 


RPC 


390010 


10 


File Browser Daemon 


edmlinkd 


RPC 


390011 


11 


EDM-Link Daemon 


bamd 


RPC 


390012 


12 


Backup Activity Monitor 


edmdispd 


RPC 


390015 


15 


Dispatch Daemon {EDM Restore) 


07dbapi 


RPC 


390018 


18 


EB Database API Daemon for Sybase 


tf smd 


Socket 


390020 


20 


TFSM Calypso Daemon 



Low Port Number: 
High Port Number: 
Transient Offset: 
Fixed Ports : 
Reusable Ports : 
Socket Option (s) : 
Lookup Method : 
Service Type 
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Port Control 



Installing Port Control on 
the EDM Client(s) 



After port control has been enabled on tlie EDM, select Install 
Client from the Backup menu of the EDM GUI. The Backup 
Client Install Wizard appears. Select the client(s) you want to 
install. 



NOS Client Access Window 



For Windows NT filesystem client(s), enter tlie username and 
password in the NOS Client Access window. 



UNIX Client Install Method Window 



For UNIX clients, proceed to the UNIX Client Install Metliod 
window. Follow the decisions you made in the Port Control 
Checklist. 

Be sure that the local firewall administrator has implemented 
the firewall rules decided on in the Port Control Checklist. 
These ports may then be closed after the installation/update of 
the EDM dientCs). 

Note: 'iTie EDM Transfer Protocol, which requires a 

password, uses tlie UNIX REXEC pi-otocol during 
UNIX client installation. Tlie remote shell uses UNIX 
RSH during U'NIX client installations. Both methods 
of installation use EDM Transfer Protocol during 
normal operations. 

Note: If the port control configuration for the EDM 

.localhost file changes, all port-controlled clients 
must be updated to get the changes. (See "Making 
Changes to Port Control" on page 4-20.) 



Port Control Window 



when you reach the Port Control window, dick: 
• Yes to enable port control if it is not already enabled on the 
client. If port control is already enabled on the client tliis 
will overwrite the settings with the current settings on the 
EDM server. 
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Installing Port Control on ttie EDM Client{s) 



• No to leave the port control settings on the client as tliey 
are. This will not enable, disable, nor update port control 
on the client. 

Note: If you do not reach the Port Control wndow, the 
sen-er does not have port control enabled. Enable 
the seiver using eb_server_config before 
proceeding. 

Once a client has port control enabled and the configuration 
saved, it can be reinstalled without specifying port control, 
unless port control is removed from the client using the ports- 
crvices command (see the portservices man page). 

Note: You cannot install a client using an IP address, then 
move it beliind the firewall, and give it a new IF 
address. 
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Port Control 



Making Changes to Port If your port conti-ol configuration changes on tJie server, EDM 
Control clients should be reinstalled to specify the new settings. If 

changes liiive been made, the edm_services.client_tempiate file 

appears on tlie EDM. 



To Change System Monitoring customers accessing clients through a firewall which does not 
for Ping Errors allow ICMP packets to pass through in both directions may get 

RASD errors. While the default configuration for RASD is to 
check the availability of all clients, tliis setting can be modified 
through the System Monitor window in the GUI. 



To Change the Default Port if you want to change the default range, begin with the EDM, 

Range then reinstall the clientCs). 

1. To change the range from the default of 8000:8250 to 
9000:9250, shut down the server, remove the old port 
configuration, make the changes, activate the changes on 
the seiver, and restart as shown below: 

edm# edmproc -shutdown 

edint portservices -portaonf default -low 9000 -high 9250 
editit portservices -activate 
edmf edmproc -restart 

2. Install the edm_services files on eveiy port-controlled EDM 
client(s) as follows: 

edm# portservices -portconf <client> -low 9000 -high 9250 

edm# portservices -copyto <client> 



An Alternative Method Open die firewall for REXEC or RSH and reinstall the EDM 

clientCs), selecting "Yes" in the Port Control window. Iliis will 
change the ranges on the clients to match the new range on the 
EDM. 

Close the firewall for REXEC or RSH. 
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Making Changes to Port Control 



To Enable Port Control with 
eb_server_config: 



To determine if an EDM has port control enabled, enter 

portservlces -disp localhost. If there are no edm_services 

files, the EDM does not have port conffol enabled. 

If you want to enable it, do the following: 

edm# edmproc -shutdown 

edin# load_portfile [ options] 

edint portservices -activate 

edmt edmproa -startup 

edm# rpoinfo -p | grep 3900 

rpcinfo displays the following: 



390007 
390011 
390010 

390008 
390012 
390015 



tcp 
top 
tcp 
tcp 
tcp 
tcp 



39552 

8011 

8010 

6008 

8012 

8015 



Compare the right column for 390011, 390010, 390008, 
390012, and 390015 with tlie settings shown by portser- 
vices -disp localhost (see ".localhost File" on page 4-17). 
For instance, 39001 1 has a low port number of 8000 and an 
offset of 11. Add these to get 8011 and compare to the 
output of rpcinfo. 
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Port Control 



To Turn Off Portmapper on the to tum off ponmapper on the edm: 

1. On die edm: 

edm# edmproo -shutdown 

edmt portservices -portconf localhost -lookup services 
edm# portservices -activate 
edin# edmproo -restart 

2. Install the changed edm_sei-v'ices files on all of the port 
controlled EDM c]ient(s). 

edmt portservices -copyto < every port controlled client> 



An Alternative Method Open xhe firewall for REXEC or RSH and reinstall the EDM 

client(s), selecting "Yes" in the Port Control window. This will 
change the ranges on the clients to match the new range on the 
EDM. 

Close the firewall for REXEC or RCMD. 

Note: To turn portmapper back on, use -lookup 
portmapper instead of -lookup sei-vices 



To Turn Off Portmapper on To turn off portmapper on client(s): 

Client(s) 

On the edm, for each affected client: 
edmt portservices -portconf <client> -lookup services 

edin# portservices -copyto <client> 

Note: To turn portmapper back on, use -lookup 
portmapper instead of -lookup services 



To Set Portmapper Off for New To set tlie default for anv new port control client, enter the 
Clients foiio^v •ing on the edm: 

edmt portservices -portconf default -lookup services 

Note: To turn portmapper back on, use -lookup 
portmapper instead of -lookup services 
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Making Changes to Port Control 



To Disable Port Control for a To disable port control on a single client, do the following on 

Single Client the edm: 

edm# portservices -removefrom <clientname> 

This removes the edm_sen'ices files from the client and saves 
the edm_serv'ices file for tlie client in a .template file on the 
EDM. If port control is enabled for the client at a later date, the 
.template file is used, thereby restoring die port control settings 
to Vvdiat they were before port control was disabled. 



To Disable Port Control on the tf you want to disable port control on the EDM and all of its 
EDM and All of Its Clients clients, do the following on the EDM: 

edni# edmproc - shutdown 
edm# portservices -removeall 
edmt edmproc -startup 

If any client(s) cannot be reached, the edm_sen'ices files on the 
client are not removed and must be removed manually. Hie 
edm_sendces files are located in the sub-directoiy etc/csc under 
the directoiy in which the EDiVl client software was installed 
(usually /usr/epoch). 
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5 How Backup 
and Restore 
Work 



This chapter provides an in-depth description of what actually 
happens during the backup and restore processes. ITie 
ibilowing topics are discussed: 

• How Backup Works 

• How Restore Works 

• Media Management 

For information on how EDM Symmettix Path backup and 
restore works, refer to die EMC Data Manager Symmetrix Path 
User Guide. 

For information on how to perfomi EDM Symmetrix Connect 
backups and restores — specifically witli the EDM Oracle Appli- 
cation Interface and Filesystem Application (for UNIX clients) — 
refer to the EMC Data Manager Symmetrix Connect User Guide. 

For information on how to perfonn EDM Symmetric Connect 
backups and restores with RMAN Proxy Copy (on UNIX clients), 
refer to die EMC Data Manager Oracle Backup Client guide. 
Similarly, see ihe EMC Data Manager EMC Backint gmde for 
information on using Symmetrix Connect with the SAP R/3 
System's SAP Tools (on both UNIX and Windows NT clients). 
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How Backup and Restore Work 

For information on how to perform EDM Symmetrix Connect 
backups and restores with the EDM-specific interfaces to NT 
filesystems and databases: 

• EMC Data Manager Windows NT Backup Client 

' EMC Data Manager Windoivs NT Oracle Backup Client 

• EA4C Data Manager Windows NT SQL Sewer Backup Client 

• EMC Data Manager Windows NT Exchange Backup Client 



How Backup Works Use the EDM Backup Configuration window or command Une 

interface to configure your filesysteni and online database 
backups. 'Ilie configuration process involves identifying and 
scheduling each client's data for backup. Once configured, 
backups occur automatically, copying the files from the clients' 
magnetic disks to the server's storage devices. 

When client software is installed on the server, the magnetic 
disk(s) on the server are handled the same way as the local 
disks on client fileservers and workstations. "^-Tien the server is 
backing up its own local data, it is referred to as the local 
backup client. 

The following is an oveiview of die backup process: 



Figure 5-1 The Backup Process 

(T) ebbackup starts one ebbackupd daemon for each scheduled vrork item 

Remote Shell or 



Client's Default (D & (D ® © © (7) 




Media Catalog Databases Completion 

Report 
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How Backup Works 

1. The ebbackup program starts one backup daemon 
(ebbackupd) Foi" each scheduled resource (work item). 
The ebbackup utilit)' is started from root's crontab file at a 
specified time. 

2. The backup daemon connects with network clients via the 
client's connection method. 

The backup daemon then tells the client what data to back 
up on that client and at what level (for example, full or 
incremental). 

3. Remote and local clients call tlie startfind utilitv' which 
starts a findxcpio process and then does a file scan. 
The client scans its filesystems and sends tlie information 
(file attributes and the files to be backed up) back to the 
server. 

4. The backup daemon on the EDM Backup server receives 
the infomiation from the clients, stores it on backup media, 
creates a saveset recoi'd for the backup, and puts file name 
and attribute information in the backup catalog database. 

5. As each work item is backed up, the catalog daemon, 
cbcatalogd. processes the backup catalog files for future 
use by the restore program. 

6. The ebbackupd daemon updates several server databases, 
such as tlie volume management and saveset databases. 
For HSM systems, ebbackupd updates the database so that 
it can determine the backup status of each client. The 
daemon updates the mtag.list to reflect correctly the 
mapping between work item names and EDM Backup/HSM 
tags; and, for baseline backups, it updates the saveset-to- 
baseline relations database to record the volume(s) and 
saveset ID of the backup. (For an understanding of HSM, 
read Part II "Hierarchical Storage Management.") 

7. EDM Backup creates backup completion reports to inform 
you of successful and failed backups. 
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How Backup and Restore Work 



Monitoring Active Backups you can monitor active backup processes and execute reports 

or queries in tlie EDM GUI. During a backup, an object in the 
Main window, such as the EDM server, a client, or a work item, 
appears as an active process, successfully backed up, in tlie 
backup queue, or failed to complete successfully. Current 
backup tliroughput also appears for an backup in progress. 

Upon completion of a backup, you can then configure and save 
backup queries to report on specific areas of importance such 
as failed work items or work items with poor performance. 

For more information about active backup monitoring and 
reporting, refer to EDM online help, "Baclaip Report Oveiview." 



Start of Overall Backup The ebbackup command, which is run out of root's crontab 

file, starts one ebbackupd daemon for every scheduled work 
item, llie ebbackupd daemon performs the backup of a work 
item listed in the work group list of the backup template. 

Backups of work items for multiple clients on the network can 
proceed concurrently. You can identify? work items that back up 
the same physical disks so that they do not run at the same 
time. This prevents disk thrashing, tlius improving tlie time to 
complete the backup. You can also assign a priority to each 
work item to control which ones are to be backed up first. 



Client Access The ebbackupd daemon connects with network clients by 

using the client's connection metliod. Remote UNIX and PC 
clients use the EDM transfer protocol or the remote shell (rsh) 
utility; online database clients use RFC. Tlie daemon accesses 
the local client (tlie server) directly. On UNIX clients, it invokes 
the startfind script on the client system. 
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How Backup Works 



Work Item Specification The daemon provides the client witli a specification of the 

filesystems, directories, and/o]- files to be backed up, as defined 
in the work item configuration. 'SXlien doing this, the 
ebbackupd command takes into account tlie priority at which 
each work item is processed; tlie level of completeness of the 
backup of an HSM system; and any exclusion tags (do not 
process work item A at the same time as work item B, etc.). For 
incremental backups, the daemon also takes into account the 
date/time of the last backup. 



Automatic Sclieduling If a client that is listed in the backup schedule template's work 

group is unavailable, EDM Backup's autoscheduling ftmction 
continues to back up all of the other clients that are listed in the 
work gi'oup. On the next day tliat the client is available, EDM 
Backup perfoniis the backup. 



Backup Activity Wizard The Backup Activity Wizard enables you to start new, queued 

or failed backups, stop running backups, or manage the backup 
queue. You access this wizard from tlie Main window of the 
EDM GUI. 

Note; You must have root privileges of be an EDM 

Backup Administrator to use the Backup Activity 
Wizard. 

For more information about tliis wizard, refer to EDM online 
help. 
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How Backup and Restore Work 



EDM Backup consists of software that backs up the server and 
various network clients. 

• EDM Backup's sewer software manages all networked client 
backups. 

It provides central configuration and administi-ation of your 
client backups. The seiver software also enables you or 
your users to restore files from backup media eiisily. 

• EDM Backup's client softimre runs both on the server 
system (as a local client) and on each networked client. 
When prompted by the server, the client scans its 
filesystems and sends the server the files to be backed up. 
Refer to the KMC Data Manager Software Release Notes for a 
current list of clients. 



Standard Client Processing The client passes to the server tlie name and attributes for all 

scanned files, along with the data for those files that are 
selected for backup. Hie client sends the header information 
even for files that are not being backed up, to be able to 
reproduce die state of the filesystem at the time of the backup. 

Witli the standard backup processing model, die client sends 
this infonnadon using the "standard output" channel of the 
connection, using an extended cpio format (provided as part of 
the EDM Backup software). 



High-Sp^d Client Processing For high-speed client processing, multiple data streams are 

generated. The header information, which contains die 
attiibutes, is sent in one stream to the server, which in turn 
w^rites the header datii to a backup catalog. Another stream that 
contains the file data is sent to the backup media. 



Client/Server Processing 
Methods 
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The server writes the header data to a backup catalog and sends 
the file data to the second seiver process, which in turn writes 
the data to tlie backup media. 



Filesystem backups ai-e performed while you are online. Files 
are monitored as the backups are processed, so ii" a file changes 
while it is in the process of being backed up, the backup of that 
file is rejected and another is scheduled. 

To reduce the backup workload, filesystem backups include 
incremental backup as well as full backups. A level-9 incre- 
mental backup backs up only those files that changed since 
their last backup. Each night, by defauk, the server sofnvare 
schedules 11x11 backups for some hosts and incrementals for the 
remainder. The scheduler rotates tlie full backups among all of 
the hosts over a rotation period, which by default is tvv^o weeks. 

You can restore individual files from filesystem backups. 

Baseline backups, which are available with the HSM option, 
back up your most stable files. From that point on, you perfomi 
backups relative to the baseline. 

Refer to the EMC Data Manager Symmetrix Connect User Guide 
for information on backing up UNIX, Oracle, and Windows NT 
filesystems using EDM Symmetrix Connect. 

startfind and findxcpio are utilities that are patt of the EDM 
Backup software. The startfind client script runs a filesystem 
scan utility' called findxcpio to collect backup data from the 
client. Hiis utility operates through tlie filesystem interface so it 
can W'ork while the client's filesystems are active. 
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EDM Backup can detect that a file is being changed while it is 
being backed up. If findxcpio detects that a file changed, it 
backs up the file again. Ilie findxcpio utilit^^ tries to copy the 
file up to three times before it sldps it. Under tliese conditions, 
the file is backed up on the next scheduled backup. 

For more information refer to Appendix D "findxcpio Direc- 
tives" . 



Database Backup There are several ways to back up databases, as described in 

Chapter 6, "Database Backup and Restore" of this manual. 

Note: For Symmetrix Conned, see also the EMC Data 

Manager Symmetrlx Connect User Guide, the EMC 
Data Manager Oracle Backup Client guide, the EMC 
Data Manager EMC Backint gu ide, the EMC Data 
Mmmger Windcrws NT Oracle Backup Client guide, 
tl'ie EMC Data Matmger Windows NT SQL Server 
Backup Client guide, and the EMC Data Manager 
Windows NT Exchange Backup Client guide. 



ACL Support An Access Control List (ACL) provides an enhanced level of 

security for U.MX files. ACLs extend the standard UNIX 
permission settings beyond owner, group, and otlier. An owner 
of a file can permit or deny access to specific users and groups. 

For a list of platforms that support ACLs, refer to the EMC Data 
Manager Software Release Notes. HP, IQM, DEC, and Sun 
platforms implement ACLs differentiy. Refer to the appropriate 
client documentation for details. 



Backing Up Files with ACLs Hie backup software retains ACL settings when a file is backed 

up. During the backup process, backup writes die ACL to the 
media along with the data. When restored, backup propedy 
restores tlie data with the same permission settings to the origi- 
nating or same type client. 
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IBM clients support file ACLs up to one memory page (approxi- 
mately 4096 bytes) in size. However, backup does not retain a 
file's ACL if it exceeds 1024 b)tes. 

If you attempt to back up a file that has an ACL larger tluin 1024 
bytes, the backup process backs up the file without the ACL 
data. Only the standard UNIX file permissions are preserved. 

This also produces an error message. If tliis error occurs often, 
consider adding more user groups to manage file access 
logically. 



Restoring Files with ACLs When you browse backup catalogs and mark files for restore, 

ACL settings are not visible in the file listing. However, backup 
checks the ACL settings and proliibits users who do not have 
permission to restore the file. A user can have access according 
to standard UNIX permissions but is prohibited from accessing a 
file if specified by the ACL. On the other hand, if a user lias 
access to a file via tlie ACL but does not have standard UNIX 
permission, the user cannot mark the file for restore. 

Due to die way that ACLs were implemented in Solaris 2.5.x, 
restore of ACLs on directories is not supported. (Restore of ACLs 
on files is supported.) llie way Solaris 2.5.x implemented ACLs, 
the root accoimt cannot change die ACL of a file or a directory 
of which root is not the ownei". Tlie restore software 
reconstructs directories from tlieii- attributes, but since no owner 
is defined, the restore softvt'are is unable to set the ACL. 



Cross-Client Restore The backup software does not support cross-client restore of 

ACLs. An ACL setting is retained only if you restore die file to 
the same platform Vfpe. For example, if you back up a file with 
ACL settings from an HP platfomi you can only restore the file 
with its original ACL to an HP platfonn. If you restore the file to 
another non-HP platform, the file is restored but the ACL is not 
retained. 
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Client ACL Commands The commands that you use to list and set ACLs differ for each 

platform. Table 5-1 lists ACL user commands for the HP-UX, 
IBM AIX, Sun Solaris, and DEC UNIX platforms. Refer to the HP, 
IBM, Solaris, or DEC UNIX documentation for more 
information. 



Table 5-1 Client ACL Commands 



Operating Command Description 

System 



HP-UX 


chacKl) 


Change ACLs of files 




getaccess(l) 


list access rights to files 




Isacl(l) 


List ACLs of files 


IBM AIX 


acledlt(l) 


Edit an ACL 




aclgetCl) 


Ust ACLs of files 




aclput(l) 


Set an ACL for a file 


Sun Solaris 


acl(2) - 


Edit an ACL 




aclsort(3) * 


Sort an ACL 




getfacl(l) 


List ACLs for a file or files 




setfaclCl) 


Set an ACL for a file or files 


DEC Unix 


getacld ) 


List ACLs of files 




setacKl) 


Set an ACL for a file or files 



• System call or library llmction 



Client Pacing You can use Client Pacing to control the network bandwidth 

that the network backup clients of the EDM use. Enabling 
Pacing frees up computer resources for use by other 
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applications. Pacing then ensures that the average network 
utilization over a period of time does not exceed a specified 
threshold, thus "pacing" resources among applications. 

Note: Client Pacing is available on all UNIX clients except 
Auspex and SunOS. 

To use of the Client Pacing feature, do the following: 

1. Make sure you install (or reinstall) the client after installing 
the EDM ser\''er software. 

2. Create a file "pacer.cfg" on the client, in the director}' 
/usr/epoch/EB. This file should have read permission for all 
users, 'lliis is a single line text file with the forniat; 
Threshold \debug_mode] 

where; 

nreshold specifies the tlireshold value in KB/sec. The 
smallest permissible value for threshold is 100 (KB/s). 
dehtig_mode is optional. Valid values are: 

a. "Verbose," which writes Pacer trace messages to the file 
pacer.log in /trap. Verbose is for temporary use; 
continued use could flood /tmp. 

b. "quiet," which suppresses Pacer trace messages (the 
default if no value is specified). For example, to limit 
die network utilization to 1000 KB/sec, this file should 
have an entry of 1000. 

3. Run your backups as usual. 

When the backup process starts on tlie client, it reads this file. 
If tlie file is successfully read and parsed, the pacing feature is 
enabled, and a message is sent to be logged in the file 
back'ups.log, in directory /usr/epoch/EB/log, on tlie EDM 
server: 

Client Pacing is enabled for this backup. Threshold = 1000 
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where the threshold value is the one set in pacer.cfg on the 
client. You may easily disable the pacing feature by 
commenting out the pacer.cfg entry using or removing the 
file pacer.cfg from the client. 

Note: Understand tliat Client Pacing is done at the 

expense of the backup throughput. Overall backup 
performance is, by definition, impacted. 

Keep in mind the following important points: 

• The threshold value is applied to each backup tliat may be 
running for the client. It is NOT a collective threshold for all 
backups. So, for example, if tlireshold is set to 1000 KB/sec, 
and two backups are running concurrently for the same 
client, each is paced to the order of 1000 KB/sec, and the 
overall network utilization by all of the backup pi-ocesses is 
2000 KB/sec. 

• Once the backup process begins on the client, tlie pacer.cfg 
file is not read again. Tlius, any changes to this file do not 
affect any backups that are already running. 

» The threshold value should be perceived as an 
approximation. The EDM client attempts to keep the 
average tliroughpui over a period of time under die 
threshold value, but the network utilization at any particular 
instant is not guaranteed to be equal to the threshold. 



Server Processes Attributes when the backup server receives the files from the client, the 
and Data ebbackupd daemon creates a backup saveset on the serv-er to 

hold the contents of the backup data stream that it receives 

from die client system. 

The ebbackupd daemons can interleave savesets from different 
clienLs on the same piece of liackup media, allowing many 
backups to occur simultaneously. 
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The allocation and use of backup media is managed by Volume 
Management through the trail concept. A trail is a collection of 
backup media of the same type, which you expand by 
allocating new media as needed. You specify the type of media 
to use for each backup level when you define the trail. 

The ebbackup program can optionally alternate trails eveiy 
other day. This enables you to segregate data between separate 
and identifiable sets of media, which makes it possible to store 
backups off site. 

To restore files, the restore program (called from the Restore 
window in the EDM interface or from the ebrestore command) 
uses the backup catalogs, which are essentially a snapshot of a 
client's file names at tlie time of tlie backup. The EDM Restore 
window enables you to browse through the file names at any 
point in time, and to select individual files or entii-e filesystems 
to restore. For more information, refer to the section "How 
Restore Works" on page 5-1 6, 



Catalog Processing when a backup is first completed, the raw data for the 

associated catalog exists on the server, but the catalog daemon 
(ebcatalogd) must process the raw catalog before the restore 
program can use it. You can have catalog processing performed 
concurrently witli backups, or you can schedule catalog 
processing for a later time so tliat tills task does not slow down 
backups. 

By default, ebcatalogd starts when the system boots. To start 
and stop processing, add the following commands to the 
crontab file: 

/usr/epoch/EB/config/daemon_startup -ebcatalogd 
/usr/epoch/EB/config/daemon_startup -stop 

Refer to the ebcatalc^d man page for more information. 
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Server Database Update i he ebbackupd daemon is responsible for maintaining several 

server databases, such as the saveset, volume management, and 
the catalog databases. 



Report and Log File Generation when a backup completes, you can configure and save backup 
queries to report on through the EDM grapliical user interface 
(GIJ!), as described earlier. Ilii-ough this reporting you can 
gather information about a backup such as it status, total 
througliput, total size of the backup, and total files that were 
backed up. (Refer to EDM online help, "Backup Report 
Overview" for more information.) 

At backup completion, tlie system also generates eitlner a 
backup completion report to confirm backup operations or a 
backup failure report. For examples, refer to "Backup 
Completion Reports" on page 16-29 and "Backup Failure 
Reports" on page 16-31 for more information. 

The ebbackup utility can email success and/or failure reports to 
the system administrator or to a configured list of users. 

Tlie ebbackupd daemon records progress reports in the sei-ver 
log file of each work item as it is backed up. 



Backup Completion Reports Backup completion reports describe successfiil backups. These 

reports list tlie backvip template name, the backup start date 
and time, the name of the backup trail, each client and what 
was backed up from it, the amount of kilobytes of client data in 
the backup, any clients that were unavailable for backup, the 
total number of clients, files, directories, and the backup 
completion date and time. 

The server eb_server_cooJftg installation procedure creates the 
mailok script to which it passes tlie backup completion infor- 
mation. The script mails the reports to individuals who are 
responsible for f)ackup operations, and/or writes tliem to a log. 
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Backup Failure Reports Backup failure reports list the backups that require manual 

inten'ention to proceed. These reports contain only serious 
erroi- messages, such as notifications of an interrupted backup 
or of a backup tliat could not start. Backup failure reports do 
not include errors from which EDM Backup automatically 
recovered. 

The server installation procedure creates the mailerr script to 
which it passes tlie backup faUure information. Tlie script can 
mail the reports to individuals respoixsible for backup opera- 
tions, and/'or write them to a log. 



Backup and Restore Logs The ebbackupd daemon records progress reports in the sender 

log file of each work item as it is backed up. During setup, a 
logging level is specified in each baclcup schedule template, 
which controls how much information this file contains. You 
can modify the default logging level, which is stats. 

The /usr/epoch/EB/1og directoiy on the server contains tlie 
following log files: 

• backups.log — contains an audit trail of backup-related 
activities listed in chronological order. EDM Backup adds 
information to this file each time it backs up a template's 
work items. Selected notifications that appear in this log file 
also appear in other backup reports. As each log file 
accumulates information, EDM Backup removes the oldest 
ten percent of the data after the file reaches a configured 
maximum size. 

• recoveries.log — contains an audit trail of restore-related 
activities that are listed in clironological order. EDM Backup 
adds information to this file each time it performs a file or 
database restore for a client. 

• A log file for each backup template — contains the backup 
history for a single backup template, llie information in this 
log varies depending on the logging level you specify in the 



EDM Software Reference 



5-16 



How Backup and Restore Work 



configuration database. Tlius, you can use the file to view a 
histoiy of backup-related events for a single template. The 
log files are named 1emplate_name.\og. 

For more information, refer to "Log Files" on page 16-35. 



How Restore Works Tlie restore program provides a means of retrieving data from 

backups, which ensures that lost or damaged data can be 
quickly replaced. 

Note: For Spnmetrix Connect, see also tlie EMC Data 

Manager Symmetrix Connect User Guide, the KMC 
Data Manager Oracle Backup Clieni guide, the EMC 
Data Manager EMC BackinI guide, and the various 
Windows NT client guides. 

Table 5-2 gives you an understanding of the valid restore padis 
for the three types of backup paths. 



Table 5-2 Backup versus Restore Path 



Backup Path Restore Path 



Network Symmetrix Path Symmetrix 

Connect 



Network Yes Yes No 

Symmetrix Path Yes Yes No 

Symmetrix Connect Yes ^ Yes ^ Yes 

1. You cannol restore Symmetrix Connect data via network or Symmetrix Patli tf your Symmetrix 
Conned liackup is a ,strijx;d LVM configuration. You also cannol re.slore a Windows NT 
Symmetrix Conned iMckup via network or Symmetrix Path. 

The restore program offers self-service file retrieval. You can 
configure the backup server so diat users on UNIX client 
systems can perform file restore without the aid of a system 
administrator. 
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The EDM Backup sei-vcr trackt. user names and the dients from 
whicli tliese users have permission to rcstcjre files. This provides 
s\-stcm securit}' b)' enabling access control on a per client 
system basis, 'llie software also enforces I 'NIX file permissions 
and Access Control Lists, if supported by the client. Tsers can 
restore only tliose files for which the\' have access permis.sion. 

Note: Refer to your EMC Data Manager Software Release 
Xotes for a cun-eni list of client platfonns that 
support ACLs. 

Click this icon in the Main window (jf the EDM GUI to 
^^^"1 open the Restore window, or entei" the command 



Use the CLI command edmcrestore to open the Restore 
window on clients. The EDM makes tlie connection and 
opens die Restore window. Alternatively, users can issue tlie 
command ebcrecover to restore files. 

Note: 11ie ebcrecover command on tlie client calls 
ebrecover on the EDM, but as of EDM 4.5.0, 
ebrecover is just a symbolic link to the actual 
restore program, ebrestore. 

CRefei- to die edmrestore, edmcrestore, and ebcrecover man 

pages for more information about these commands.) 

The restore program (ebrestore) runs on the server and 
enables you to extract data from backup media. Restore works 
with the help of on-line catalogs that keep track of all files that 
are saved on each backup volume. 

Note: Tiy to avoid restoring a work item that is currently 



Figure 5-2 shows an overview of tlie file restore process: 




being backed up. 
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Figure 5-2 



The File Restore Process 



User on Client 



Server 



(D Connects to the server 
and starts restore 

d) Specifies which files to restore 



(3) Locates the files 
using the backup 
catalog 




0 Server invokes 
restore script 
on the client 




Backup Media 



0 Information (g) Client writes the 
about restore files to its local disk 
in recoveries.log 



Backup Catalog 

® Sends files back 
to the client 






1 . A user on a client system issues the edmcrestore 

command to connect to tlie sen-er and start up the restore 
window. 

During one restore session, a user can restore files from 
different backup savesets. lliis causes tlie restore progi-am 
to combine catalogs to reproduce the state of the filesystem 
at the time of the request. 

2. A user searches for and marks files to restore. Tlie sen'er 
then locates the backup savesets that contain the specified 



Note: When restoring offline database backups, you must 
select all stripes from the same backup date. You 
cannot restore one stripe, for example, from one 
backup date and another from a previous date. 

3. The backup program scans the saveset records, which 
identify the backup catalogs, and locates the media that 
stores the backup data. 



files. 
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4. The restore program connects to the client using the 
client's native connection method (or direct connection in 
the case of a local client). 

In either case, an EMC-provided i-estore shell script is 
invoked on the client system. Tlie backup daemon provides 
the client script with a specification of the files to be 
restored. 

5. The restore program reads the files being restored from the 
server's storage devices, packages the files in an extended 
cpio format, and sends them to the client system. 

6. Tlie client system wi-ites tlie files to its disk. 

If the fi.les are being restored to the original client, the 
restored files oveiwrite any files that already exist on that 
client (unless the user specifies an option to not overwrite 
existing files). If the files are being restored to a different 
client, the server restore the files to tlie requested location. 

7. Information about the restored files is written to the recov- 
eries.log file on the client and on the seiver. 

The recoveries.log includes the name of the user who is 
performing the restore operation, die total amount of data 
restored, and tlie date and time of the restore. 



Media Management The server's volume management software manages all media 

for backup and HSM (for netNN'ork backups only). Tlie software 
controls the library unit robotics that automatically insett media 
into and remove them from drives when an application requires 
their use. 

For an understanding of media management, refer to Chapter 7 
"Basic Volume Management Concepts" and Chapter 8 "How 
Volume Management Works." 
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Expiring Backups as time passes, your site will have many volumes of backup 

data. If tlie site no longer needs to keep older backup data, it 
can specif}' that backups tliat are older than a certain age be 
automatically expired. XX'lien every backup with data on a 
volume has expired, die media is made available again. Ilie 
volumes that are made available via expirations are made 
available only for dieir current trail. You may relabel these 
volumes to remove this restriction. 



Deallocating Baseline Volumes in HSM systems, baseline volumes do not expire directly but 
become deallocated (that is, available for reuse) when three 
conditions are met: 

• The volume is no longer the current volume for the trail. 

• The volume is not referenced by any baseline-relative 
backup. 

• No block on the volume is in use; that is, no data is actively 
referenced by the current file system (as when a baseline ID 
in a file's metadata points to the volume). 



EDM Software Reference 



6 Database 
Backup and 
Restore 



Various options are available for database backup and restore. 
Backups can be either over the netw-ork or over SCSI or Fibre 
Channel cabling from a Symmetrix storage system. Tliis chapter 
describes the several ways to back up databases. 

Note: Prior versions of EMC Data Manager included an 
"offline" backup feature for Oracle, Sybase, and 
Informix databases — no option required. EDM no 
longer includes this feature. See "EDM's Legacy 
"Offline" Database Backup Feature" on page 6-17. 

'Fliis chapter includes the following topics: 

• Varieties of Database Backup 

• Various Database Backup Clients 

• Database Network Backup Overview 

• EDM Symmetrix Patli Overviem- 

» EDM Symmetrix Connect Overview 

• EDM's Legacy "Offline" Database Baclaip Feamre 
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Varieties of Database EDM supports database backup and restore over networks or 

Backup through attached Symmetrix storage units. Database support is 

provided by optional backup clients and by two Synnnetrix 
options, EDM Symmetrix I'ath and EDM Symmetrix Connect. 

The database backup clients provide network backup for the 
various major databases on numerous system platforms. In 
addition, all of the clients work with EDM Symmetrix Patli (on 
the most popular system platforms). Finally, some of die clients 
work with EI3M Symmetrix Connect as applicable, but EDM 
Symmetrix Connect also provides specialized backup interfaces 
in some cases to support database backup. 

XX'hichever backup methodology' used, the EDM centrally 
manages backup processing and media operation. I^rovided that 
adequate tape drives are available, EDM can run Symmetrix- 
related and network backups at the same time. 

EDM's network backup is an effective solution for data centers 
with many small to medium-sized database and fileservers. 
Netwoi-k l:)ackups and restores are accomj^lished through ATM, 
FDDI, Fast Ethernet, or Token Ring network connectlonCs). Tlie 
network backup function scales well, performs multiple 
backups at once, and centralizes backup and media 
management. 

The EDM Symmetrix Path option offers channel- speed backup 
of large databases (and filesystems) over a data patli through 
Symmetrix storage units to the EDM. Backups and restores are 
done over Fibre Channel or SCSI cables connected between the 
database host, the Symmetrix, and the EDM. 

The EDM Symmetrix Connect option specifically addresses the 
backup needs of very large databases. Backups and restores 
done over Fibre Channel or SCSI cables connected directly 
between tlie Symmetrix and the EDM, providing a direct 
backup of the database (or its mirrored -copy) on Symmetrix 
storage units to the EDM. 
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DatabaSS Backup Clients EDM's database backup clients support various databases from 

major vendors, specifically; OracleT", SAP R/S"^" System (Oracle 
database), Sybase®, Informix'''', Microsoft SQi;"*' Server, and 
Exchange. Unix and Windows NT platibrms are supported. (See 
the EiMC Data Manager Software Release Notes for a current list 
of supported client platforms and operating system versions.) 

For the most part, these database backup clients provide 
backup and restore of database systems tlumigh interactions 
with die standard backup utilities provided by the database 
vendor for use with their databases. For example, the EDM 
Oracle Backup Client supports backups by OracleT's Enterprise 
Backup lJti]it\' (EBU) and OracleS's Recovery Manager (RjMAN). 

Depending on the database client, backup and restore opera- 
tions are initiated from tlie database system, from the EDM, or 
i'rom eidier system. 



EDM SymmetriX Path The EDM Symmetilx Path option is available for use with all the 

database backup clients. See the KMC Data Manager Software 
Release Notes Ibr a cuirent list ol' database versions and 
operating system versions supported for EDM Symmetrix Patli. 

Instead of streaming backup data over the network from the 
database host to the EDM, EDM Symmetrix Path streams the 
data over the Fibre Channel or SCSI cables betm-een tlie 
database host, the Symmetrix, and the EDM. (The network is 
still used for control communication between tlie EDM and the 
client.) Once configured for EDM Symmetrix Path, a client's 
backups and restores can be switched between EDM Symmetrix 
Path and the network widi a simple reconfiguration. 

In supporting EDM Symmetrix Patlt, the database clients interact 
witli die database backup utilities in the same way as they do 
for network backup. For example, the EDM Oracle Backup 
Client supports EBU and RMAN backups over Symmetrix Padi. 
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EDM SymmetriX Connect The EDM Symmetrix connect option supports backup of a few 

key database systems, (Oracle, Microsoft SQL Server™, and 
Exchange) residing on Symmetrix storage units. It also supports 
backups of fllesystems. 

With EDM Symmetrix Connect backups, data on the Symmetrix 
(either the database oi- a mirrored-copy) is streamed over the 
cables directly from the SymmeDix to the EDM. Tlie netv.'ork is 
still used for control communication betVk-'een the EDM and the 
client and for backup and restores of archived redo logs and 
control files. 

EDM Symmetrix Connect backs up data for a few key database 
applications and fllesystems. Two of its application interfaces 
are standard; the odiers are EDM-specific interfaces. 

EDM Symmetrix Connect backs up UNIX Oracle databases 
through two standard interfaces: 

• RMAN Proxy Copy (for some UjNIX platforms), enabling 
backups and restores through Recovery Manager (RMAN) 

• EMC Backitit, SAP-certified interface (for some UNIX 
platforms), enabling backups and restores through SAPDBA 

The RMAN Proxy Copy application supports Oracle's RMAN 
utility's Proxy Copy backups in conjunction with the EDM 
Oracle Backup Client. For RMAN Proxy Copy, backup opera- 
tions can be initiated from the database system or the EDM; 
restores can be initiated from the database system only. 

The EMC Backint application supports the SAP R/3 System's 
SAPDBA backups of Oracle databases, using the SAP R/'3 
System's standard BACKINT interface in conjunction with the 
EMC Backint client. For EMC Backint, backtip and restore 
operations are initiated from the database system. 
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In addition, EDM SymmetJ-ix Connect has two EDM-specific 
interfaces to Oracle: 

• EDM Oracle Application Interface (for several UNIX 
platforms), enabling backups and I'estores tlirough EDM 

• EDM interfaces for Windows NT systems for Oracle, 
Microsoft SQL Sen'er, and Exchange 

With the EDM Oracle Application Interface, EDM Symmetrix 
Connect is tailored to work widi directly with Oracle databases 
on the following client platforms: Compaq, HP, IBM, Sequent, 
and Sun. Rather than interacting with the Oracle backup 
utilities, the EDM Symmetrix Connect software provides its own 
interface to the Oracle database. 

Similarly, EDM Symmetrix Connect's Windows NT interfaces 
support backups of Oracle, Microsoft SQL Sei-ver™', Microsoft 
Exchange"^" (as well as filesystems on Windows NT). See the 
EMC Data Manager Software Release Notes for a current list of 
supported client platforms. 

For the EDM-specific interfaces, backup and restore operations 
are initiated from the EDM. 
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VsriOUS Ddt3b3S6 BSCkUP EDM supports various, distinct database clients tliat are 
Clients packaged separately as options. 



Oracle Backup Client The EDM Oracle Backup Client, which interacts with tlie Oracle 

backup utilities, is available for many UNIX client platforms and 
Windows NT. It supports network, EDM Symmetiix Path, and 
EDM Symmetrix Connect (RMAN Proxy Copy) backup. Tliis 
option is installed and configured tlirough the EDM graphical 
user interface (GUI). See EMC Data Manager Oracle Backup 
Client for installation and configuration Instructions for UNIX 
platforms. For Windows NT, see the EMC Data Manager 
Windows jVT Oracle Backup Client tnanual. Also see the online 
Help in the GUI. 



EMC BaCkint Client for SAP The EMC Backint client, which is a sofWare interface to the 
R/3 Oracle Databases sap R/3 system for backing up its Oracle database, is available 

for many UNIX client platforms and for Windows NT. It 
supports network, EDM Symmetrix Padi, and EDM Symmetrix 
Connect backup. Tliis option is installed and configured 
through the EDM GUI. EMC Backint has its own client manual 
with specific installation and configuration instaictions. See the 
EMC Backint manual. 



Other UNIX Database Backup Sybase and Informix databases each have corresponding 
Clients database clients, with individual client manuals with specific 

installation and configuration instructions, which are available 
for most client platforms. Tliey support ne^vork backup and 
EDM Symmetrix Path. These options are installed and 
configured tlirough the EDM GUI. See the EMC Data Manager 
Sybase Backup Client and EMC Data Manager Informix Backup 
Client manuals. 
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Microsoft Database Backup Microsoft SQL sender and Microsoft Exchange each have corre^ 
QlientS spending database clients, with individual client manuals with 

specific installation and configuration instructions. They support 
network, EDM SymmetrLx Path, and EDM Symmetrix Connect 
backup. These options are installed and configured tlirough tlie 
EDM GUI. See tlie EMC Data Manager Windows NT SQL Server 
Backup Client and EjMC Data Manager Windows NT Exchange 
Backup Client manuals. 



Database Network 
Backup Overview 



Database backups can be initiated from within the database 
management system or on the EDM. In the first case, the 
database administrator starts tlie backups from within the 
DBMS's own backup utility. In the second case, the EDM's 
scheduling function starts a process that, in turn, automatically 
starts the backups within the DBMS's own backup/restore 
utility. 

Table 6-1 lists the backup and restore utilities for each database 
svsteni. 



Network Database Backup and Restore Utilities 



Database System 



Oracles 
Oracle? 

Oracle under SAP R/3 

Sybase 
Informix 



Database's Backup/Restore Utility 



Itecovery Manager (RMAN) 



Enterprise Backup Utility EBU 
(obackup) 



SAPDBA (BRBACKLff, BRARCMIVE, 
BiyZSTORE) 



dump/load 
On-BAR 
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Once started, the DBMS's backup utility' scans the database for 
data to back up and passes the data to the backup client 
software. 'Hien tlie backup client software streams the data to 
the EDM over the network. 



Multiple Streams To speed up backup processing, you can create multiple 

streams of backup data from tlie database (for example, six). 
You can also decide to write the backups to multiple tapes (for 
example, two). The difference in tlie two example numbers 
represents a consideration of the generally slower speeds of 
magnetic disks (which hold the database) as compared with 
tape drives (which write the backups to tape). 

Note: The various implementations of streaming for each 
database client are described in their respective 
manuals (or release notes, as applicable). 



Server-side Processing The server softw 'are manages tlie writing of data to tape storage 

media and provides online catalogs, located on EDM's own 
disks. Separate paths for data flow and for conti-ol (catalog 
inl'ormation), allows the data to take a more direct patli to tlie 
backup media. 

The catalogs enable restores of your data from the backup 
media. (In the case of tlie Backint SAP R/3 client, the client 
software also creates catalogs at a meajiingful granularity for the 
database system and stores them locally on the client.) 

The server soffw^are also manages the operation of robotic 
libraiy units and provides overall volume life-cycle 
management. Also, die software enables automated backup 
expiration. 
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The client software receives restore requests from tlie database's 
restore utility' at a database, tablespace, or data file granularity, 
as appropriate, and sends the requests to the sei-ver software. 

The server software retrieves the data from the backup media 
and sends it to the client software, whicli passes it on to the 
database's own restore utility. 



The backup clients can be installed through the EDjM Backup 
Install Wizard and configured through the EDM Backup Config- 
uration Wizard. They can be reconfigured dirough either tlie 
EDM Backup Configuration Wizard or the EDM Backup Config- 
uration window-. Some command-line procedures might also be 
required. 

See the appropriate EMC manual for information on installing 
clients, configuring backups, and restoring data. 

Note: Although the Restore window might display work 
items for the following database products, it does 
not support restores for: Oracle Backup Client, 
Sybase Backup Client, Informix Backup Client, and 
KMC Backint. Restores are accomplished through 
each database's restore utility. 



Multiple-networked backup, meaning that if tlie client machine 
has multiple interfaces, the client can send backup data through 
those multiple interfaces. 

You can specify which interface to use by Work Group/' 
Schedule, using the Use Client Name parameter in the Work 
Item tab's Work Item Options window (in the Generic lab). This 
parameter con"esponds to the connection via parameter of 
the "listener" work items in tlie eb.cfg file. 
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Note: A separate issue is die use of multiple network 

interfaces on the EDM. For database backup clients 
cmly, the client must have a valid EB sender 
hostname in its /usr/'epoch/EB_DB/ebci.conf file. 



Database Pre-DiSCOVery During initial client configuration from the Backup Configu- 

ration Wizard, the client machine is scanned for the presence of 
databases, in a process called pre-discoveiy. 

Pre-discovery reveals just two pieces of information: 

• Database type (that is, Oracle, Sybase, Infomiix) 

• Database name 

No special requirements exist for Oracle databases to be pre- 
discovered; the Backup Configuration Wizard presents the 
databases listed in the /etc/oratab file as the databases that exist 
on the system. However, for Sybase and Informix databases, 
there are assumptions as to where the database software was 
installed, as described in Table 6-2. 
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Requirements for Database Pre-Discovery 



Database System 



Requirement for Pre-Discovery 



None. The Backup Configuration Wizard presents the databases listed in the 
/etc/oratab file as the databases that exist on the system. 
Note: Tf the file lists a database that actually does not exist, it is shown 
anyway, as pre-discover)' is not able to ascertain whether in Fact 
the database does not actually exist or if it is just off line. 

One of the following on the Sybase machine: 

• A link, "/SYBASE", to the direaory in which the Sybase database software is 
installed. 

• The environment variable "SYBASE" for the I'oot environment pointing to the 
dii-ectoiy in which the Sybase database software is installed. 

• A UNIX account named "sybase" in whose home directory (as specified in 
/etc/passwd) ilie Sybase database software is installed. 

Eithei' of the following on the Infomiix machine: 

• The environment variable "INFOIMIXDIR" in the root enviromiient pointing 
to the director)' in which the Informix database software is installed. 

• A UNIX account named "informix" in whose home directory (as specified in 
/etc/passwd) the Infojmix database software is installed. 
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EDM SymmetriX Path The EDM Symmetrix Path feature currently works with tlie EDM 

Overview Oracle Backup Client, die EMC Backint client, Sybase client, 

xVlicrosoft NT SQL Server client, Microsoft Exchange client, and 

Informix client. 

EDM Symmetrix Path enables an EDM to back up your database 
(and filesystems) thi-ough direct SCSI connections to a 
Symmetrix, rather tlian over a local area network. 

With tliis methodology, the Symmetrix itself acts as the network. 
A few small devices are designated as transport paths for config- 
uration purposes, while the actual data transport is generally 
handled by the cache on the Symmetrix corresponding to these 
devices. 

Note: As they are dedicated to transport, these devices are 
unavailable for use as storage devices. 

These Symmetiix Transport Groups (also referred to as ST 
groups or STGs) are mapped to the hosts (clients and the EDM). 
Various possible device configuration and host mapping combi- 
nations provide different performance characteristics and 
degrees of flexibility'. 

Note: The database can be located on the Symmetrix on 
volumes that are accessible to the dataliase host. 
But unlike with the EDM Symmetrix Connect 
methodology, the database volumes are not made 
accessible to the EDM, nor are mirror-images of the 
database volumes. 

Each of the various possible device configuration and host 
mapping combinations provide different performance character- 
istics and degrees of flexibility. See the EMC Data Manager 
Sym metrix Path User Guide for more information. 
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EDM Symmetrix Connect With EDM Synimetrix Connect, databases are located on one or 
Overview more Symmeti-ix systems in various configurations that are 

visible to die EDM. The baclcup data is sent over SCSI or Fibre 
Channel cabling that directly connects the EDM to the 
Symmetrix storage, llie backup is usually taken from a mirrored 
copy of the database on a Symmetrix (ihi-ee different miirored- 
volume configurations are available), but a non-miixored config- 
uration, which backs up the database itself, is also supported. 



Applications EDM symmetrix Connecfs EDM Oracle Application Interface 

supports backup of Oracle databases for UNIX (Sun, IBM, HP, 
Sequent, and/or Compaq clients). Tlie Filesystem Application of 
EDM Symmetrix Connect adds the capability to back up 
selected filesystems on UNIX systems. 

Other EDM Symmetrix Connect applications support Oracle 
backups through l^MAN Proxy Copy and through EMC Backint 
(for SAP R/3 System Oracle databases). Botli online and offline 
database backups can be performed. 

EDM Symmetrix Connecl's Windows NT applications support 
Oracle, Microsoft SQL Server, and Microsoft Exchange (as well 
as Windows NT filesystems). 



User Interfaces On the EDM, the EDM Backup Configuration Wizard is used for 

client configuration of EDM Symmetrix Connect. 

The Backup Activit}' Wizard or EDM's command-line interface is 
used for EDM-initiated backup. 

Restores of EDM Symmetrix Connect backups taken through the 
EDM Oracle Application Interface are EDM-initiated using tlie 
command-line. Restores of Oracle R^'LAN Proxy Copy bacloips 
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are always performed on the client, through RMAN. Restores of 
EMC Backint backups are always perfonned on the client, 
through SAPDBA or BRRESTORE. 

The EDM GLIFs Library Manager window is available for media 
management operations. 



Documentation see the EMC Data Manager Symnietrix Connect Usei- Guide for 

detailed information on how? to perform each operation for the 
EDM Oracle Application Interface and for the filesystem appli- 
cations. 

See the EMC Data Manager Oracle Client guide for RMAN Proxy 
Copy, the EMC Data Manager Backint guide for EMC Backint, 
and the KMC Data Manager Windows NT Oracle Backup Client 
guide for NT Oracle. 

See the other Windows NT client guides corresponding with the 
EDM Symmetric Connect backups of your Windows NT system. 



Raw Device Backups For the most part, EDM Symmetrix Connect performs its 

database backups at the physical disk, that is, raw device level. 
Raw device backups have the advantage of fast backup perfor- 
mance. Tlieir limitation is that they do not offer die granularity 
of file-by-file (logical) backups and restores. 

If your database files are built on raw devices, than the raw 
device backups are perfectly suited. 

If your database files are in fiiesysterns. logical filesystem 
backups are available if your database seiver (the backup 
client) is running the same operating system as the EDM. 

Otherwise, raw device backups of database files in fiiesysterns 
will give you fast backup performance but also a lack of file-by- 
file granularity in backups and restores. 
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Configurations Databases can be located on one or more Symmetrix systems in 

various configurations. EMC offers a direct connect backup and 
restore solution in a combination with four Symmetrix volume 
mirroring configurations as shown in Table 6-3. 



Table 6-3 




EDM Symmetrix Connect Mirroring Configurations 


Backup 
Solution 


Symmetrix ^ 
Configuration 


Description 


Symmetrix SRDl- 
('(jnnection 


iijf ' 
a b 


Backup of "target" {"R2") \'c)lumes on a second, connected Svinmetrix 
(b). which mirror the ■'source" ('•Rt") \-olumes on the first Symmetrix 
(a), which contain the database 


'I'imel-inder 


'l~ a 
b 


Backup of "Business Continuance Volumes" C-BCVs") ib). which 
mirror the "standard" ("S'I'D") vohimes (a), which contain the 
database, all of which arc on one Symmetrix 


Remote BCX 


-5- a b 

^ — c 


Backup ol "BCA's" (c) on secontl SymunetrLx. which niiinjr "target" 
("Hi") \'olumes on the second Symmetrix tb) that miiTor the "source" 
("Rl") \-olumes on the first Symmetrix (a), which contain the database 


Non-mirrored 


T a 


Backup of non-mirrored volumes (a) containing the database 



1 . For ail EDM Symmetrix Conneci solutions, ihe Symmetrix models are 3xxx/5xxx ESP model systems. 
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Mirrored Configurations The first three configurations listed in Table 6-3 take advantage 

of volume mirroring, v*/hich is when one (or more) exact copies 
of the database's disks are maintained simultaneously. 

One mirroring capability is betm'een two physical Symmetiix 
systems (the Symmetrix SRDF configuration). The other 
mirroring capability is between disks on a single Symmetrix (the 
TimeFinder configuration), llie Remote BCV configuration uses 
botli mirroring capabilities together. 

To perfomi the backups, the EDM logically discontinues tlie 
active mirroring between the database disks (or the target "R2" 
volumes, in the case of Remote BCV) and the mirrored copies. 
The database host can continue to function normally using the 
primary Symmetrix disks wliOe the EDM backs up the (now 
static) mirror-copy of the database (or tablespaces) rather than 
the database itself. At the time the mirrors were split, the two 
volume sets were exact copies of each other. 

Backups can be online or offline. In a mirrored configuration, 
when perfomiing online backups, the database is put into 
Oracle's online backup mode only briefly, just for the time the 
mirrors are split. (If any inconsistencies occur wliile the mirrors 
are split, they can be resolved by the Oracle software at restoi-e 
time.) 'llierefore, for tliese mirrored configurations, the database 
host (client) is not impacted by the online backup operation. 

When perfomiing offline backups with the EDM Oracle Appli- 
cation Interface, the database or tablespace remains offline only 
briefly, just for the time the mirrors are split. However: 

• For EMC Backint, the database or tablespace remains offline 
for tlie entire duration of the backup. 

• For RMAN Proxy Copy, the database, tablespace, or datafile 
remains offline for the entire duration of the backup unless 
a post-min-or-split script is employed to bring the database, 
tablespace, or datafile online after min-ors have been split. 
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Non-Mirrored Configuration in the Symmetrix non-mirrored configuration, the actual client's 

database is backed up, not a mirrored copy of it. To use tliis 
Feature, the Oracle data files cannot reside in a filesystem, Tlie 
data files must be in raw partitions. 

The database can be backed up either online or offline. When 
performing online backups in a non-miiTored configuration, the 
database is put into Oracle's online backup mode for the entire 
duration of the backup. 

Note: The extended time for online l^ackup mode may be 
an issue for certain customers since Oracle 
overhead can be significant, if major updating is 
being performed during online backup mode. The 
effects of online backup mode overhead can be 
reduced by configuring backups, such that fewer 
tablespaces are requested per backup run. 

When perfomiing offline backups, the database or tablespace 
remains offline during the entire duration of the backup. 



EMC Data Manager formerly included an "offline" database 
network backup feature for Oracle, Syb ase, and Informix 
databases, for which no option was required. 

Support for performing backups with this feature has been 
removed. 

However, EDM does continue to support restores for any 
backups taken with this functionality using prior versions. 

Also, EDxM continues to support backups of these databases on 
most of the same client platforms through tlie use of EDM's 
Oracle, Sybase, or Informix backup clients. 



EDM'S Legacy "Offline" 
Database Backup Feature 
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7 Basic Volume 
Management 
Concepts 



Volume management software manages and controls access to 
attached library units and all removable media that EDxVI 
Backup and the optional HSM software use. 

This chapter describes the components that comprise the 
volume management software. 

The topics in tliis chapter include: 

• Volume Management Overview 

• EDM Library Unit Manager 

• Volume Manager 

• Library Managers 
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Volume Management 
Overview 



The volume management software provides removable media 
management sei-vices to Bacloip and optional HSM software. 
The software includes tlie following components: 

• EDM Libraiy Manager (GUI and CLI) 

• Volume Manager 

• Device-specific Libraiy Managers 



Volume Management Software 



Library Unit Manager 
Window (GUI) 




Robotic Library Units 
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EDM Library Unit Manager The EDM Libraiy Unit Manager, which resides on the EDM 
Backup seiver, is your interface to volume management 
limctions. For example, you use tlie EDM Library Unit Manager 
to: 

• monitor volume activity on the EDM server 

• inject and eject volumes from the library unit 

• label volumes for use 

• locate available volumes 

• checl< for outstanding media requests 

• initiate partial or complete library unit inventories 

The interface interacts with the underlying software 
components, which the following sections describe. 



The Volume Manager manages: 
" information about all volumes 

• volume life cycle 

• volume requests that applications make (for example, 
backup and media duplication) 

The Volume Manager maintains a group of files on the server 
in the directory /usr/epoch/etc/vm. This directory contains a 
configuration file (vm.cfg), the volume catalog (volumes), 
template catalog (templates), log file (clog), and other 
administrative files. 

Note: With the exception of vm.cfg, volume management 
uses all of the files in tliis director)' internally. You 
should not edit any of these files. 



Volume Manager 
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VoiUilie Catalog volume management identifies all volumes by a unique 

electronic volume label on the media. Tlie Volume Manager 
keeps track of all volume information in the volume catalog. 
The catalog contains entries for each volume including the 
volume ID, volume sequence number, physical location (by 
Library Manager), volume state, optional barcode ID, and usage 
count. 

The Volume Manager updates the catalog as operations and 
events occur, such as when: 

• new media enters a libraiy unit 

• a volume is allocated to an application 

• volumes in a libraiy unit are inventoried 
e a volume is ejected from the library unit 

• a volume is imported from another seiver 

• a volume is moved from offline to offsite 

The volume catalog is an integral part of volume management 
software and necessary for rebuilding an EDM system. 
Therefore, the catalog as well as all vokmie management 
system files are backed up as part of tlie default sei-ver work 
group. 



Volume Life Cycle a volume's Hfe cycle (as illustrated in Figure 6-2) begins when 

you label a new tape or optical disk. The labeling process 
writes a unique electronic label to the media. A labeled tape, 
such as DLT, holds one volume. Two-sided media, such as EO 
disks, contain two volumes, one volume for each media side. 

When media is loaded into a libraiy unit, its volume label is 
read before information for the volume becomes visible in the 
EDM Libraiy Unit Manager. A volume is identified by its 
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sequence number or one of the following states: uncataloged, 
unlabeled, unverified, foreign, expired, or erasing CEO disks 
only). These states are described below. 



Volume Life Cycle 




An uncataloged volume indicates tliat die volume has a valid 
volume latel but is missing from llie volume catalog. Tliis can 
happen if the volume was labeled on another server or if die 
volume catalog was lost as a result of a server disk crash (see 
Chapter 20 "Recovering a Server from a Disk Failure"). 

If you import the volume, die Volume Manager adds an entry to 
the receiving seiver's volume catalog, llie volume retains its 
volume ID and volume sequence num!3er that the Volume 
Manager of the originating server assigns. 

Volume management does not allow duplicate volume 
sequence numbers of the same media type. If you attempt to 
import a volume that has a sequence number that already 
exists, you are prompted to either delete die existing volume or 
cancel the import operation. (Refer to "Duplicate Volume 
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Sequence Numbers" on page 8-26 for instructions on how to 
override tliis restriction.) Volumes that are contained on 
different media types (for example, EO and DLT) may have the 
same sequence number. 

An unlabeled volume means tlie volume's label area is islank. 
Tills is the state of new media. You can either label die volume 
or leave it unlabeled until an application makes a request for a 
new piece of media. 

When you insert an unlabeled volume into a libraiy unit, the 
Library Manager assigns it a slot number, moves tlie volume into 
the slot, and notifies the Volume Manager to add an entry for 
the unlabeled volume to the volume catalog. 



A foreign volume is any previously-used media from a 
non-EDM system. A tar tape is an example. 

To reuse a foreign volume, you must first label it. When a 
foreign volume is labeled the Volume Manager adds it to the 
volume catalog and changes its state to available. If the media is 
an EO disk, the data on the disk is erased before it is labeled. 

The EDM Libraiy Unit Manager also allows you to mount 
foreign volumes for the purpose of reading or extracting data. 
You can do this by manually (or force) mounting the volume 
into a drive using the Force Mount liutton in the Utilities tab of 
the EDM Libraiy Unit Manager window. 

Note: You must dismount the volume manually to avoid 
preventing other processes from using tlie drive, 

Tape media expires when it reaches a pre-set maximum usage. 
After backup deallocates a volume, the Volume Manager checks 
the usage count and expires the volume after the maximum is 
reached. (See Figure 7-3 on page 7-9.) When a volume expires, 
it cannot be mounted for data access. 
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Erasable optical disks have an erasing state tliat occurs at 
different stages. EO disks enter the erasing state before a 
foreign EO is labeled and after HSM deallocates the volume. 
(See Figure 7-4 on page 7-10.) 



An unverified volume means that die Library Manager is unable 
to recognize the label contents on die volume. An unverified 
volume can result for one of many reasons: the volume was just 
injected and did not yet complete the initial label read; the 
media is incompatible, an error occuired while the label was 
being read; a hardware problem occurred; or a user placed 
several volumes into a library unit (LU) through tlie mass load 
door and then ran a barcode-only inventory. 

Generally you should inventory an unverified volume so that its 
label is read properly. For a library unit that supports barcodes, 
perform a barcode and label inventory; for a non-barcode LU, 
perform a label inventory. 

Note: A barcode and label inventory is recommended. 

If a drive becomes dirt}? while the volume is in the drive and its 
label is being read, the Libraiy Manager automatically dismounts 
the volume, disables the drive and marks it as dirty, and tries to 
read the volume's label in another drive. If this second drive 
also becomes diity, the Libraiy Manager dismounts the volume, 
places it back in its slot, and marks tlie volume as unverified 
and offline. Tlie Libraiy Manager then disables this second drive 
and marks it as dirty, and places it back into the LU. 

If the LU contains a cleaner cartridge, the drive is cleaned 
automatically; if no cleaner resides in die LU, injecting a cleaner 
starts an automatic cleaning. You must then verif\' the unverified 
volume either through a mount request or an inventory of that 
slot (barcode/label or label inventoiy). 

Note: If the volume remains unverified after an inventory, 
remove it from the library unit. 



EDM SoHware Reference 



Zl. 



Basic Volume Management Concepts 



How Volumes are Allocated a volume becomes available for allocation after it is labeled. 

Labeling a volume requires tliat you choose a volume template. 
Volume templates enable you to specify whether a volume 
should be made available to any application (tliat is, Backup or 
HSM), to any trail, or to a specific trail. 

Several volume templates are available: 

• Unrestricted {media Jype) — any application 

• EBprelabel — backup only 

• HSMprelabelEO — HSM only 

• Resti'icted to trail_name — specified ti-ail name only 

The templates also contain atti-ibutes that the volume inherits 
such as: a unique volume ID, trail name, media type, maximum 
usage count, and media size information. 



When a Volume is Allocated volume allocation begins with a request from backup, media 
duplication, or HSM. The Volume Manager locates an available 
volume based on tlie application's request, provides a volume 
ID, gives the application access to the volume, and changes tlie 
volume state to Allocated. 

Volume usage is based on the number of times diat a volume 
transitions from Available to Allocated. Each time the volume is 
allocated, the Volume Manager increments die media's use 
count by one. When a volume reaches its maximum usage, the 
volume is expired . 

The figures on the following pages illusti-ate the volume life 
cycle of two media t^^pes. Figure 7-3 illustrates the life cycle of 
tape. Figure 7-4 on page 7-10 illustrates the life Q'cle of erasable 
optical media, and Figure 7-5 on page 7-11 illustrates tlie life 
cycle of WORM (Write One Read Many) optical media. 
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Tape States 
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Figure 7-4 EO Volume States 
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Figure 7-5 



WORM Volume States 
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Library Managers Device-specific libraiy Managers control library unit operations: 

• library unit inventories 

• drive preemption 

• robot movement for mounting and dismounting media 

• injecting or ejecting media 

Offline and offsite Library Managers hold information about 
volumes in offline and offsite locations. Library Managers are 
supplied for various types of libraiy units. 



Library Manager Configuration you use the Imconfig utility to configure a Libraiy Manager for 
each libraiy unit that is attached to the sender. For each Libraiy 
Manager that you configure, Imconfig sets up a subdirectory in 
/usr/epoch/etc/lm to include the configuration file and other 
internal files that the Libraiy Manager uses. Each subdirectory 
name is based on the vendor name and model numlier. 

Within the Libraiy Manager's subdirectoiy, a configuration file 
(Im.cfg) defines features and fimctionalit)' for the device. For 
example, if a libraiy unit is equipped with a barcode scanner, 
the configuration file enables barcode support. 

After a liliraiy unit is configured, an icon for the library unit and 
each internal drive appears in the Library Units and Drives area 
of die Lil3rary Unit Manager window (only if volume 
management is running). 
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Robotic Library Units a Librajy Mana eer controls the library unit's robot 

(the mechanism that moves cartridges witliin a lilirar^' unit), 
interna] tape drives, and media inlet (if present). 

Each Library Manager maintains a per-libraiy unit inventory of 
volumes in the file volid.dat within its subdirectoiy, When a 
Library Manager is staited for tlie very first time, it takes a 
complete inventoiy of the library unit's contents and creates the 
volid.dat file. Once the file is created, the Libraiy Manager reads 
volid.dat to initialize the lilarary unit, which eliminates a 
complete inventoiy each time the system is staited. 

The inventory list includes a volume ID, barcode lal->el (if 
supported by the libraiy unit), slot number, and drive location 
for each volume. As volumes move from one location to 
another, the Library Manager updates the inventory list and 
notifies die Volume Manager of any clianges. 

The Libraiy Manager also controls drive scheduling and drive 
selection. 'Wlien tlie Volume Manager makes a request for an 
operation (for example, a mount request) the Library' Manager 
adds the request to a prioritized Vv'ork queue. When a drive 
becomes available, the Libraiy Manager services tlie next work 
item with the highest priorit)'. 



Offline and offsite Library Managers enable you to track tlie 
location of volumes that are outside of a physical library unit. 

Offline represents volumes that are ejected from a library unit 
and stored in a nearby area, usually somewhere on site. Tlie 
offsite Library Manager holds inlbrmation about volumes that 
you physically move to a location beyond the building's 
boundaries, such as an offsite archival location. Only volumes 
that have a volume label or barcode label can enter the offline 
or offsite Libraiy Manager. An unlabeled volume with no 
barcode is deleted from the volume catalog when it is ejected 
from tlie LLJ. 



Offline and Offsite Library 
Managers 
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The EDM Libraiy Unit Manager window displays an icon for 
offline_0 and offsite_0 Libraiy Managers. From tliis window, 
you can view the volumes that are contained in both the offline 
and offsite Librar)' Managers. You can also eject volumes into 
either tlie oiBine or offsite Libraiy Manager using the Eject tab 
in the Libraiy Unit Manager window, (Refer to EDM Online 
Help for instructions.) Tlie Utilities tab in this window provides 
a text field that enables you to record the volume's actual offline 
or offsite location. 

Note: Moving l3ackup media offsite before its rotation 

period ends causes the backup that would use that 
media to fail. You can avoid a failed backup by 
using new media for the next backup. You 
configure the use of new media in the Backup 
Configuration window of the EDM GUI. Select 
Advanced Options in the Schedule Tab. In the 
Schedule Options window that appears, select Use 
New .Media When Current (backup media) Is 
Offsite. 

The offline_0 and offsite_0 configuration files specify- tlie action 
to be taken when a mount I'equest is received for a volume that 
is offline or offsite. 



When you eject a volume from a library unit by using the Eject 
tab in the Libraiy Unit Manager window, the default destination 
is offline. (Volume Manager detemtines where to put the 
volume by the value of LM_EJECT_DEST that is set in the 
vm.cfg file.) 

The Eject tab also enables you to eject volumes to offsite. 
Knowing whether a volume is located offline or offsite is 
helpful when you need to locate a volume for an application 
such as a restore. If the volume is not in any library unit, the 
Media Request window specifies whether tlie volume is offline 
or offsite. 



8 How Volume 
Management 
Works 



Tlie information in this cliapter is intended for the system 
administrator wlio wants in-depth knowledge of the volume 
management software. It describes tlie volume management 
processes and how they work together to provide sendees to 
EDM Backup and HSM software. 

Tliis chapter covers the following topics: 
» rvmoper UNIX Group 

• Volume Management Processes 

• Volume Management Startup 

• Library Unit Operations 

• Volume Allocation and Deallocation 
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rvmoper UNIX Group 



Normally, users who are not root can only monitor volume 
management activity. However, if you are a member of the 
rvmoper UNIX group (/etc/ group), you can perform volume 
management functions, such as labeling media, and injecting 
and ejecting media from a library unit. 

Note: To become an r\'moper member, contact your UNIX 
s>'srem administrator, who can add you to the group. 



Volume Management 
Processes 



The Volume Management softw^are consists of several 
independent processes that together provide volume 
management services to Backup and HSM. Figure 8-1 il 
these processes: 



Figure 8-1 



Volume Management Process Diagram 
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You can view currently running volume management processes 
by using the evmlistd command. (Refer to the evmlistd man 

page for more information.) Following is an example of 
cuiTently running processes; 

# evmlistd 



root 3966 


3964 0 


Nov 


18 ? 


4 


36 


notd -d 


root 3983 


3964 0 


Nov 


18 ? 


40 


01 


. . /atl__3264^0/lmd 


root 3964 


1 1 


Nov 


18 pts/6 


10 


18 


/usr/ epoch/bin/vmd 


root 3984 


3964 1 


Nov 


18 ? 


7 


05 


. . /of fsite_0/lmd - 


root 3985 


3964 1 


Nov 


18 ? 


6 


52 


. . /offline 0/lmd - 



Done 



yolUITiS MsnSgSr The Volume Manager (vmdaemon) is tlie principal process in 

volume management. It interacts with EBFS (Epoch Bitfile 
System), device-specific Libraiy Managers, and the notify 
daemon. EBFS enables applications, such as Backup and HSM, 
to write data to removable media. Libraiy Manager daemons 
(Imd) control library unit operations such as robot movemenl 
which transports cartridges to and from an LU's inlet, internal 
drives, and storage slots. 'The notify daemon communicates 
changes betu^een the Volume Manager and Library' Managers, 
and EDM Librat}' Unit .Manager graphical user interface (GUI). 

You can also view the current status of the Volume Manager by 
using the evmstat command. Various options enable you to 
view the status of components such as drives, inlets, individual 
library units, etc. (Refer to the evmstat man page for more 
information.) 

Backup and HSM invoke requests to the Volume Manager to 
open and close volumes, obtain volume status, and to allocate 
and deallocate volumes. 
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Librsry MsnsgerS individual Library Manager processes manage library unit 

operations on a per-device basis. A Library Manager is set up for 
each libraiy unit that is configured for the EDM by using the 
Imconfig utilit)'. 

Requests for media are sent from an application to the Volume 
Manager. Upon receipt of a request, the Volume Manager passes 
the request to the appropriate Library Manager for processing. 

The Libraiy Manager notifies die Volume iManager and EDM 
GUI, via the notify daemon, when it completes an operation. 



Notify Dasmon The volume Manager and eacli Library Manager communicates 

with die GUI by way of the notify daemon (notd). Tlie notify 
daemon enables the GUI to display up-to-date status and 
information during system operation. For example, when you 
label a new piece of media, the Volume Manager sends the new 
volume label information to the EDM Library Unit Manager by 
way of die notify daemon. Tlie Media List is updated to display 
information for the newly labeled volume such as its volume 
sequence number, tlie application making the request, and the 
trail name. 



Volume Management The vmdaemon is .started from the system startup file. The 

Startup vmdaemon starts the notify daemon, sets the parameters 

defined in its configuration file (vm.cfg), and starts an Imd 
process for each Library? Manager configured for die server. 

During startup, each Libraiy Manager daemon reads a unique 
configuration file (Im.cfg). Tlie configuration file defines the 
name of die library Manager, sets die hardware address of the 
libraiy unit and drives, configures the number of drives and 
drive features, and sets the library unit's operating and 
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scheduling parameters. (See "Library Manager Configuration 
Files" on page C-9 for more information about die parameters in 
the Library Manager configuration file.) 



Manually Stopping and under nonnal operating conditions, you do not have to start up 

Restarting the Vmdaemon or shut down the volume management system. When you 

reboot the system, volume management processes are 
automatically shut down and restarted. 

However, you may need to shut down and restart volume 
management if die vmdaemon fails or you determine tliat one 
or more processes are in an unknown state. Volume 
management does not automatically recover from unexpected 
vmdaemon failures. 

Note: Manual shutdown of the vmdaemon should be done 
only by EMC field service personnel or when 
instructed by an EMC customer sei-vice 
representative. 



Using edmproc -restart To recover from this type of faOure, use the edmproc -restart 

command, lliis command shuts down the remaining EDM 
processes and tlien starts up all of the processes again in the 
coiTect order. (Refer to tlie edmproc man page for more 
information about this command.) 

You should be sure no backup, media duplication, HSM, or 
restore processes are running when you use this command. Use 
the command vmdupd -L to check on media duplication 
processes, ebbackup -L to check on backup processes, 
ebrestore for restore processes, or emsstat for HSM processes. 
(Refer to tlie appropriate man page for more information about 
each of these commands.) 

Following is an example of the output tliat appears at the CLI 
when you use the edmprcK; -restart command: 
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# edmproc -restart 

EDM daemon shutdown . . . 

Shutting down System Monitoring . . . Done 
Shutting down Backup Activity Monitor , . . Done 
Shutting down Client daemons . . . Done 
Shutting down Backup Server ... 12/27/99 15:10:25 

r 16226: ebcatalogd] Halt signal sent to ebcatalogd process #1830 

Halt signal sent to EpochBackup Listener process #1806 
Done 

Shutting down Bitfile Services . . . halting ebfsd, pro^ 
Bitfile Services shutdown complete 
Media Duplication shutdown started 
Media Duplication shutdown complete 

Done 

Status of file /kernel/drv/st . conf is good 
Shutting down Volume Management . . . Done 

Shutting down SNMP support . . . Done 
EDM daemon shutdown complete 
EDM daemon startup . . . 

Starting SNMP support . . . Done 
Status of file /kernel/drv/st . conf is good 

Starting Volume Management . . . Done 

Starting Bitfile Services . . . Done 

Starting Backup Server . . . Done 

Startup Client daemons . . . Done 

Starting Backup Activity Monitor . . . Done 

Starting System Monitoring ...Done 

Done 

EDM daemon startup complete 
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If an Error Occurs While Using if the ebfsd or vmdupd processes do not shut down witliin one 

edmproc -restart and one-half minutes of tlie restart request, edmproc -restart 

liaits the processes and forces a shutdown. A series of error 
messages may appear before the sliutdown tliat address one of 
the following processes: ebfsd, vmdupd, or vmdupmedia 
(which vmdupd controls). 

For example, if a problem occurs with shutting down tlie ebfsd 
daemon, the following message appears: 

Sending kill signal to ebfsd, process id process id 

If more time pa.sses without a successful shutdown, another 
message appears: 

Process ebfsd pid pid is slow to shut down, sending kill signal 

If all subsequent attempts to shut down the pi'ocess are 
unsuccessful: 

Unable to shut down (ebfsd) process id process id. 
You must perform a UNIX shutdown to terminate this 
process . 

You should then reboot the EDM server to clear tliis process 
successfully. 
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Library Unit Operations Library Manager daemons handle the following libraiy unit 
operations: 

• Inserting Media into Library Units 

• Mounting and Dismounting Volumes 

• Ejecting Media from a Libraiy Unit 

• Drive Sclieduling and Preemption 
» Library Unit Inventories 



Inserting Media into Library Media cartridges enter a library unit (LU) tlirough tlie library 
Units unit's inlet. Library units have one of two inlet types; automatic 

or manual. If a library unit has an automatic inlet, the Library 
Manager polls the inlet periodically for incoming cartridges. If 
the LU has a manual inlet, you must inform the Library Manager 
when you place media into the inlet. You do this in the Utilities 
tab of the EDM GUI's Libraiy Unit Manager window. (Refer to 
EDM online Help for more infomiation about tliis window.) 

When a Library Manager detects media in an inlet, it first checks 
the library unit for an available slot. If a slot is available, the 
robot moves it from the inlet into the next available slot of the 
LU. This slot becomes the volume's "home slot." llie Libraiy 
Manager inventories the volume and sends infomiation for the 
new volume to the Volume Manager (by way of the notify 
daemon). The Volume Manager creates an entry in the volume 
catalog and notifies the EDM Libraiy Unit Manager to display 
the new volume in the Media List. 
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Importing a Volume Volumes are imported into the EDM system when their status is 

Uncataloged (refer to Cliapter 7 for more information about this 
volume state). You must inject an uncataloged volume into a 
libi^ary unit before you import it into an EDM. 

The import feature is generally used for restore or disaster- 
recovery' purposes, so tliat you can transfer one or more 
volumes from one EDM to another. The receiving EDM can then 
obtain the same information about the volume tliat the original 
EDM had. 

Refer to Chapter 19 "Recovering a Server from a Disk Failure" 
and Chapter 20 "Recovering a UNIX Client from Disk Failure" of 
this manual for information about disaster recovery. 

You can import the volume into an EDM through tlie Library' 
Unit Manager window of the EDM GUI (r-efer to online Help for 
instructions). You can also import a volume at the CLl by 
entering the command evniimport (refer to tlie evmimport 
man page for more information). For example: 

# evmimport -V -1 atl_452_0 -s 39 

Using this command adds inlbrmation about the volume to the 
volume catalog, and the volume is cataloged. 

Importing a Duplicate Volume Before Its When importing a duplicate volume into an EDM system where 
Original the original volume is unknown, the duplicate's barcode, 

volume ID, and sequence number are imported witli it. The 
volume ID of the duplicate's original volume is also imported. A 
"placeholder" sequence number is created for the original 
volume in the LU. (This placehcider provides the original 
volume a valid sequence number; it does not affect backup or 
restore processes.) The original volume's barcode remains 
blank. 
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If you then import the original volume into die same EDM 
system, tlie original volume's proper sequence number replaces 
the placeholder sequence number that was created for it. 'Ilie 
original volume's barcode also updates to match the real 
volume. 

Gathering Media Information When a volume is imported, tlie fields contained on the label 

(such as volume ID) are set in tlie Libraiy Unit Manager of the 
EDM GLIl, or by running evmimport. Other media information 
that EDM uses is set by running ebimport (such as the ebfs ID 
and ebfs director)' ID). 

Other information such as the amount of data written to the 
media (which appears in die media list information in the 
Library Unit manager window of tlie EDM GUI) cannot be 
retrieved. However, this lack of information does not affect 
nomial EDM operations (backups, restores, duplications, etc.). 



Inserting Cleaning Cartridges into You insert a cleaning cartridge into a library unit (LU) as you do 
Library Units a data tape. The Library Manager recognizes the tape as a 

cleaner by its barcode wlien the cleaner enters the LU. (During 
configuration of the LU, the default barcode for cleaners is set to 
CLNXXX. Refer to Chapter 17 "Configuring Libraiy Managers" 
for more information.) 

When you inject a cleaner into an LU for die first time, die 
default for the maximum number of times the cleaner can be 
used is set to 20. As a cleaning cartridge is used, its remaining 
uses count is decremented. 

Note: If barcodes are not used, die cleaner barcode is not 
CAMXXX, or cleaner barcode recognition is disabled, 
you must inject the cleaner through die Utilities tab 
of the Library Unit Manager window, or by using 
the evnunlect -c command at the CLI (refer to the 
evminject man page for more information). 



EDM Software Reference 



8-11 



Library Unit Operations 

You can change die maximum uses count by using the 
evmchvol command in which you specify tlie lAl name and 
slot number where the cleaner resides, as shown: 

# ewichvol -1 ljhi:azy unit name -s slot nmtoer niaxuses=n 

If the cleaner was already used a number of times before being 
inserted into the LU, you can ensure this usage count by using 
the evmchvol command as follows; 

# evmchvol -1 library unit name -s slot nuiriber uses=n 

You can verify the uses or maximum uses count that you set by 
viewing the values in the hiformation tab of tlie Libraiy Unit 
Manager window, in the EDM GUI. 

After tlie cleaner is used for the first time, the Libraiy Manager 
tracks the numl3er of times the cleaner is used until it reaches 
the set maximum. 

Note: Be sure to have another cleaning cartridge available 
when a cleaner in use reaches its maximum usage. 

(Refer to the evmchvol man page for more information about 
this conmiand.) 



When Drives are Busy when you insert (inject) media into a libraiy unit, and all drives 

are busy, the inject does not complete until a drive is available. 
An inject operation does not preempt any job tliat is currently 
using drives, even if that job is a lower priority than the job tliat 
requested the inject. (An inject requires a drive to read the 
volume's label.) 

For example, backups have a higher priority' tlian media 
duplication. But if all drives are busy with a media duplication 
operation and a request anives causing the Media Requests 
window to open, you can insert a volume but the inject does 
not complete until a drive is avaOable. (See "Drive Scheduling 
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and Preemption" on page 8-16 for related information.) To 
avoid tliis problem, make sure you always have sufficient media 
in the libraty unit for the higher priority job. 

Inserting media for a higher priority job waits for a lower 
priority job to release the drive, it does not preempt any job that 
is currently using the drives, even if that job is of a lower 
priority than the job tliat requested the inject. (An inject requires 
a drive to read die volume's label.) 

Note: To avoid this problem, you must make sure you 
have sufficient media in the library unit for the 
higher priority job prior to starting the job. You can 
also configure a trail to use fewer drives during 
processing (refer to EDM Online Help for more 
infomration). 



Mounting and Dismounting Library Managers handle mount and dismount requests on a 

Volumes priority basis. The following sections describe mounting and 

dismounting media. 



Mounting Volumes When a mount request arrives, the Library Manager first 

deteraiines if the volume is mounted in a drive or one of the 
storage slots. If the volume is already mounted in a drive, the 
Library Manager sends the Volume Manager the drive number in 
which the volume is mounted. 

If the volume is in one of the libraiy unit's storage slots, die 
Library Manager schedules the volume for mounting. When a 
drive becomes available, the Library Manager mounts the 
volume, reads its volume label, and sends the drive number to 
the Volume Manager. 

If the volume is not in a drive or libraiy unit, the volume is 
eitlier offline or offsite. If the volume is offline, the Volume 
Manager generates a request for the GUI to open the Media 
Request window. The Media Request window displays the 
volume sequence number and/or barcode ID of the volume 
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(and its duplicate if one exists). To respond to the mount 
request, the operator physically locates the volume and inserts 
it into the specified library unit. 

After the volume is inserted into a librar)? unit, the Librar}^ 
Manager schedules it for mounting and tlie request is removed 
from the Media Request window, llie Library Manager mounts 
the volume and notifies the application (via the Volume 
Manager) tliat the volume is ready for access. 



When a dismount request is received from an application, the 
Library Manager first acknowledges the request, places the 
volume in a dismount queue, and leaves it in the drive for a 
specified number of seconds (LM_MAX_]DLE_TIME determines 
this number, as configured in tlie Im.cfg file). 

Note: The LMjVIAXJDLEJ'IME parameter does not apply 
when dismounting a volume from the G UI or CU ; in 
either case, the volume dismounts immediately. 

When the time tliat is specified in Im.cfg elapses, the Library 
Manager dismounts the volume from die drive and returns it to 
its home slot. If a request comes in for the same volume during 
this period of time, the volume is already mounted in the drive 
and ready for access by the application. The Librarv' Manager 
avoids remounting tlie same volume and thereby optimizes 
drive access. 

If the Library Manager receives a mount request for a new 
volume during a pending dismount and no other drive is 
available, die volume with die pending dismount status is 
immediately dismounted to free up die drive so that a new 
volume can be mounted . 
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Ejecting Media from a Library when you eject media from a Hbraiy unit, the Libi "ary Manager 
Unit schedules the volume(s) for removal from the library unit. 

Information about each ejected volume moves into the offline 
Lilirary Manager. If you specif}- to eject the media to offeite, 
information moves liriefly into the offline LM and then to the 
offsite LM. 

XX-'hen the Volume Manager receives an eject request, it first 
checks the catalog for the volume's location and sends a request 
to tlie appropriate Libraiy Manager for processing. Tlie Library 
Manager, upon receipt, schedules tlie eject request. 

If die volume is in a drive at the time tlie eject request is 
processed, the Library Manager waits for receipt of a dismount 
I'equest before ejecting the volume from tlie library unit. 

After tlie Libraiy Manager ejects a volume, all outstanding 
requests for the volume are canceled. The Library Manager 
sends notification to tlie Volume Manager to clcjse die request; 
the EDM Library Unit Manager window then reflects the change. 
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Ejecting Media Through the EDM GUI You can eject media through the Library Unit Manager window 
(Eject tab) of the EDM GUI. In tliis window, select the Eject tab, 
as shown below. Refer to EDM Online Help for instnjctions on 
using this tab. 




Ejecting Media at the CLI At the CLI, use the following command to eject media from a 

library unit; 

# evmejeot 

When you issue die command, the prompt does not reappear 
until tlie eject operation has completed. However, if you want 
to run evme|ect as a background operation, use the conmiand 
as follows: 

# evmeject & 

Refer to the evmeject man page for more information. 
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Drive Scheduling and Each Library Manager handles drive scheduling based on a 

Preemption priority that the application establishes. When a libraiy 

Manager receives a request (for example, a mount request), the 
Library Manager adds the request to a prioritized work queue. 
When a drive becomes available, the Libraiy Manager seivices 
the next work order with tlie highest priority. 



Drive Pr^mption Drive preemption occurs when a volume is mounted in a drive 

and an application makes a mount request for a volume with a 
higher priority. (The Libraiy Manager determines preemption of 
a volume based on the volume's priority in the queue.) If no 
othei- drives are available, the volume witli the lower priority is 
dismounted, which makes the drive available to the volume 
with the higher priority'. 



Verifying Priority in the Queue An application, with a mounted and open volume, periodically 

polls the Volume Manager to verify whether tlie volume should 
be removed from tlie drive. Tlie Volume Manager, in turn, asks 
the Library Manager to check for mounts of volumes with a 
higher priority. If a volume with a higher priority is waiting to 
be mounted, tlie Libraiy Manager notifies the application by 
way of the Volume .Manager to close tlie volume in the drive. 
After the application closes the drive, tlie Library Manager 
dismounts the volume, making the drive available to the 
volume with higher priorit)'. 

If all application requests are of equal priority, they are 
scheduled on a round-robin basis. For example, if five volumes 
have the same priorit}' and only one drive is available, each 
application gets a time slice of the drive. 
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LM_MAX_RESIDENT_TIME and Two parameters essentially govern drive usage: 

LM_MIN_RESIDENT_TIME LM_MAX_RESIDENT_TIME and LM_MIN_RESIDENTjriME. 

• LM_]V1AX_RESIDENT_TIME is the maximum time (in 
seconds) that a vokmie can remain in a drive before 
allowing preemption by a volume of the same priority. Tlie 
default value for tape drives is 720 0 seconds (two hours); 
the default value for EO drives is 120 seconds (two 
minutes). 

• LM_MIN_RESIDENT_TIME is the minimum time (in 
seconds) that a volume with a lower priority can be in a 
drive before allowing preemption for a volume of a higher 
priority. The default value for tape drives is 120 seconds 
(tvy'o minutes); the default value for EO drives is 30 
seconds. 

Note: You can modif)' both parameters in the Im.cfg file. 
Refer to Appendix C "Volume Management Configu- 
ration I'iles" for more infomiation about Im.cfg. 

Note: Though you can set LM_M1N_RES1DENT_TIME to any 
value, the EDM applications (backup, restore, HSM, 
and media duplication) poll drive usage every five 
minutes. Therefore, if you set the value to less than 
five minutes, preemption does not occur until five 
minutes pass and the application verifies whether 
preemption is necessary'. 



Simultanraus Backup Example The following example describes llie process of two 

simultaneous backups that are contending for the same drive. 

1 . The first backup process sends a request to the Volume 
Manager to open and mount volume sequence number 42. 

2. The Volume Manager checks the volume location in the 
volume catalog and sends a request to die appropriate 
Library Manager to mount volume sequence number 42. 

3. The Libraiy Manager creates a work order to mount volume 
sequence number 42. 
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4. A second backup process sends a request to the Volume 
Manager to open and mount volume sequence number 123. 

5. The Volume Manager checks the volume location in tlie 
volume catalog and sends a request to tlie appropriate 
Library Manager to mount volume sequence number 123. 

6. The IJbraiy Manager creates anotlier work order to mount 
volume sequence number 123. 

7. Periodically, the Library Manager is asked if the volume in 
the drive should be dismounted. 

8. The Library Manager makes a decision based on a volume's 
priority. If volume sequence number 123 has a higher 
priority, the Library Manager removes volume sec|uence 
number 42 from the drive and mounts volume sequence 
number 123 (if volume number 42 was in the drive at least 
for tlie time specified in LM_MIN_RESIDENT_TIME). 

If both volumes have equal priority', the drive is shared until 
one of the backup processes finish, or until the time 
specified in LM_MAX_RES1DENT_T1ME has passed. 



Library Unit inventories a Ubraiy Manager inventories the contents of a library unit 

based on the rype and verification criteria you select from the 
Inventory tab of the GUI. Inventory type enables you to 
inventoiy the entire contents (all slots) or only a selected 
portion of a library unit. 

Note: A label and barcode inventory is recommended. 

For most libraiy units, a Library Manager inventories each 
volume that enters a library unit by way of the inlet. If your 
libraiy unit does not have an inlet, you need to update the 
Library Manager anytime you change the contents of the library 
unit by running an inventory. You mu.st also inventory a libraiy 
unit anytime you bypass normal Libraiy Manager operations 
(for example, you move a volume using the libraiy unit's front 
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panel switches). The type of inventoiy you do depends on tiie 
activity or change you make inside the libraiy unit after opening 
the door. 

If you open a library unit door, manually move media, and then 
shut the door, the status of tlie volumes in the libraiy unit 
becomes unknown. To recover from this state, you need to run 
a label and barcode inventoiy so that the Libraiy Manager 
knows what volume is in each slot. The type of inventory you 
perform is based on what changes (if any) you make inside the 
libraiy unit after opening the door. 

Note: If your library unit has an inlet, lock the front access 
door and always use the inlet to insert and remove 
tape cartridges. If you need to open the access door 
to insert and remove large amounts of media, be 
sure to perform a delta inventor^' after each move. 

Each Library Manager maintains an internal inventory table in 
the appropriate Libraiy Manager subdirectory in 
/usr/ epoch/ elc/1 m/ volid.dat. 

Note: llie volid.dat inventory hie is created when a 
Libraiy Manager is initially started by the 
Miidaemon. This file is used exclusively by the 
fibrar)' Manager and must not be deleted. 

The table includes a volume ID, barcode label (if configured in 
Im.cfg), slot number, and drive location for each volume in the 
library unit. During an inventoiy, the Library Manager compares 
the slot contents of the libraiy unit with the information in the 
inventoiy table. If any discrepancies are found, the Librarv' 
Manager updates its table and sends the changes to the Volume 
Manager for cataloging. 
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How Inventories are Done When a Libraiy Manager receives a request for an inventory, it 

begins the process by notifying the EDM Library Unit Manager 
that an inventory is in progress. 'The word "inventoiy" appears 
next to the appropriate library unit in the Library Unit and 
Drives area of the GUL The Libraiy Manager creates a list of 
slots (based on the type you select) to inventory. 

As the Library Manager inventories each volume in its list, the 
slot contents are updated in the inventory table. If it detects any 
changes, the Library Manager sends tlie slot contents to the 
Volume Manager for cataloging. 

You can schedule an inventory during normal system 
operations. An inventoiy always has a low priority to ensure 
that maximum system performance is maintained. Tlie Libraiy 
Manager processes incoming requests of a liigher priority, such 
as mount and dismount requests, before handling an inventoiy. 
If a mount request comes in for a volume that is already in tlie 
inventoiy queue, tlie Libraiy Manager inventories the volume 
and removes it from the queue. 

After the Libraiy Manager inventories die last item in tlie list, it 
informs die Volume Manager and the notify daemon that it 
completed the inventory, llie Volume Manager modifies the 
volume catalog based on the changes that the Librar>' Manager 
provided and the GUI is updated. 

During the inventoiy process, the Library Manager processes 
incoming operations that are of a higher priority'. Tlierefore, a 
full lif-M-ary unit inventory by label does not have a noticeable 
effect on overall system performance. 
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When you perform a delta inventory, tlie libraiy Manager: 

• checks each slot in the library unit to determine which slots 
changed. 

- If tlie slot was full and is now empty, the Library 
Manager marks the slot as empty and removes the 
volume from its inventoiy table. 

- If tlie slot was empty and is now full, the Libraiy 
Manager marks the slot as needing verification. 

- If the barcode of a volume in a .slot is different from the 
barcode of a volume tliat was previously in the slot, tlie 
Library Manager marks the slot as needing verification. 

- If no change was made to the slot, tlie Libraiy Manager 
skips the slot. 

• creates a work order for each slot that needs verification 
and inventories each item using the specified verification 
criteria. 



If a libraiy unit is equipped and configured (in Im.cfg) to read 
barcode labels, you can verify only the barcode label or you can 
verifv' both the barcode label and the volume label. 

The Library Manager does a barcode inventoiy by scanning the 
barcode label of each volume in the inventoiy queue. Because 
no volume mounting is involved, a barcode inventoiy takes 
significantly less time to complete tlian a label inventoiy. Tlie 
Library Manager updates the barcode ID for each volume in its 
inventor)' table and informs the Volume Manager of any 
changes. 

When you select Verify Both Label and Barcode from tlie 
Inventoiy tab of the EDM Library Unit Manager window, both 
the barcode label and volume label are verified for the selected 
inventoiy type. (Refer to Help for the Inventory tab for details.) 
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Note: It is recommended that, when volumes are regularly 
rearranged in a libraiy unit through a mechanism 
other than the documented inject and eject 
operations (for example, insertion and removal 
through the iibrar)' unit's mass-load dcxjr), you mn 
a complete label and barcode inventory rather than 
the simple barcode inventor^'. This averts volume 
barcode and ID mismatch and cjther related 
problems that could arise in the volume catalog. 

Note: Do not use duplicate barcodes. Attempting to add 
duplicate barcoded media to the system causes 
unpredictable results. 



Cleaning Tape Drives The EDM software deteas when drives need to be cleaned. If a 

cleaning cartridge is loaded in the library unit, EDM tnounts the 
cleaning cartridge and deans the drive automatically. 

The evmclcaii command (which you can add to a cron 
procedure) requests cleaning for specific drives in a libraiy unit. 
The drives are cleaned when they become available, 
cvmclean cleans as many of the indicated drives as possible 
before exliausting the uses that remain on die cleaning cartridge. 
(Refer to the evmclean man page for more information.) 

Note: For procedures about cleaning drives manually in 
the EDM Gin, refer to EDM Online Help. 

At least one cleaning cartridge witli remaining uses should 
always be available in each libraty unit. If a drive requires 
cleaning and a cleaning cartridge with remaining uses is not 
availal')le in the library unit, the drive is disabled until it is 
cleaned. Any data tape that is mounted in tlie drive when it 
goes dirty is dismounted. If, at that time, no unused drives are 
available in the libraiy unit, the performance of any active 
backup, duplication, restore or HSM operation may be 
negatively impacted. 
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Volume Allocation and 
Deallocation 



The process of volume allocation and deallocation is initiated at 
the application level. ^X%en an application needs a volume 
allocated to a trail, it sends a request to the Vohmie Manager. 

An application determines when data on a volume is no longer 
needed and is ready for deallocation. Once a volume is 
deallocated, it becomes available for allocation. Backup 
determines if a volume is ready for deallocation when expiring 
backups. HSM handles volume deallocation following 
compaction. 



Hoiflr Volumes are Allocated During a backup, when the current volume is filled, the 

application makes a request for another volume in tlie same 
trail. The Volume Manager searches its drives and library' units 
for an available volume that matches the request. If one is 
available, it is allocated to the application. 

Additional volumes become available to a tj-ail when you label 
media. You spedly the trail name that can use it by choosing 
the appropriate volume template. You can also specify whether 
the volume is part of an available pool of new volumes, or it is 
available for a specific trail name. 

If no available volumes are in the library unit, tlie Media 
Recjuest window alerts the operator to make a new volume 
available. Tlie window includes any prelabeled volumes that 
are offline and any unlabeled volumes that can be labeled for 
the request. 
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Volume Allocation Request When an application needs a new volume, it sends a volume 

allocation request to the Volume Manager. The request includes 
a template that defines the type of volume it needs. 

Upon receipt of the request, the Volume jManager creates an 
entry in the volume catalog, assigns a volume ID to the i-equest, 
and sends the volume ID to the application. The application 
retains the volume ID. No physical media is associated with the 
request at tliis time; therefore, a volume sequence number is 
zero or barcode ID does not yet exist for the volume. 

When the application is ready to use the volume, it sends an 
open request and a mount request with the volume ID to tlie 
Volume Manager. Tlie Volume Manager searches the \rolume 
catalog for a suitable volume. ^Iien found, it sends a mount 
request to the appropriate Library Manager. 



Mount Request When the Library Manager receives the mount request, it 

schedules the request, mounts the volume when a drive is 
available, and relabels the volume as Allocated. Tlie Library 
Manager notifies the Volume Manager when the volume is 
ready for the application to access the volume. 

Note: If no available volumes match the request, the 

Volume Manager sends a volume allocation request 
notification to the EDM Library Unit Manager. The 
Media Request window opens and displays NEW in 
the Sequence # field. 
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The application retains tlie volume ID and continues to use the 
volume until it completes writing to the volume or tlie volume 
fills up (for example, a tape reaches the end of the media). 
When the application tills one volume and needs another, it 
sends another volume allocation request to the Volume 
Manager and the process repeats. 

When the Volume Manager looks for a suitable volume, it looks 
for a volume that meets these requirements: 

• The volume is not cun-ently allocated to another 
application, 

• The media rv'pe matches the media type tliat is specified in 
the template. 

• The volume did not exceed its maximum use count. If tlie 
maximum use count is set to 0, its use is unlimited. 

• The volunre restriction is i-eviewed (volume restrictions for 
a given media set are defined when the backup is 
configured); 

- The volume is labeled as Unrestricted, which allows the 
volume to be allocated to any requesting application. 

- The volume is labeled as Restricted by Application 
which means the volume can be allocated only to the 
specified application. 

- The volume is Restricted by Name which means the 
volume can be allocated only if the trail name is the 
same as that specified by the requesting application. 
This ensures that once a volume is allocated to a 
specific trail, it cannot be reallocated to a different trail. 
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Duplicate Volume Sequence Normally, volume management does not allow two volumes of 

Numbers the same media type to share the same volume sequence 

number. If you attempt to import a volume with a sequence 
number that already exists on the sei'ver, you are prompted to 
either cancel tlie import operation or to delete the existing 
volume that has the same sequence number. 

However, if your site has existing volumes with duplicate 
sequence numbers and you want to import both (or all) 
volumes, you can override tliis restriction. ITie imported 
volumes then have the same sequence numbers but different 
barcodes and volume IDs. 

Using duplicate numbers does not affect tlie running system. 
The sequence numbers enable you to identify individual 
volumes and do not affect the system's operation. 

To allow importing of duplicate sequence numbers, change the 
value of Vj\'1_ALLOW_DUP_SEQJMPORT (in the file 
/usr/epoch/etc/vm/vm.cfg) to "yes." 

Note: After you change this value to "yes," no warning is 
given when you import volumes witli duplicate 
sequence numbers. 

Following are the steps to incorporate changes to the vm.cfg file 
after adding support to allow duplicate sequence numl:)ers: 

1. (3blain the process ID (pid) of the vmdaemon: 

# evmlistd 

root 382 1 0 12:00:29 ? 2:26 

/usr/ epoch/bin/vmdaemon -d 

2. Send a HUP signal to the vmdaemon to pick up any 
changes to tlie vm.cfg file: 

# kill -HUP vmdaemon _p±d 
For example: 

# kill -HUP 382 
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When Volumes are Wlien an application deallocates a volume, tlie Volume Manager 

Deallocated takes action based on the volume's media type. 

• If the media is DLT, MTC, or DTF, tlie volume state changes 
to Available. When a tape cartridge reaches its maximum 
usage, the volume state changes to Expired. 

• If the media is EO, and is configured for auto-erase, the 
Volume Manager erases the volume and changes its state to 
Available. 

You can relabel a two-sided optical disk only when both 
sides become available. The Volume Manager treats all 
other state changes on an individual side basis, llius, one 
side of the disk can be allocated without requiring that the 
other side be allocated; one side of tlie optical disk can be 
expired, erased, made available, and allocated without 
affecting the other side. 

• If the media is a WORM (Write Once, Read Many) optical 
disk, its data cannot be ei-ased. The stale of a WORM 
optical disk starts as unlaWed. After it is labeled, the disk 
has a life cycle of Available, Allocated, and then Expired. 

For more information about volume states, see "Volume Life 
Cycle" on page 7-4. 
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Media duplication enables you to create a duplicate set of 
backup media automatically after each backup session. You can 
then use the duplicate set for disaster recovery purposes. This 
chapter includes the following topics: 

• llie Media Duplication Process 

• Starting Duplication 

• Determining Duplicates of an Original Volume 

• Manually Disabling and Re-enabling Duplication 

» Pausing, Resuming, Canceling, or Removing a Duplication 

• Restoring from Backup or Duplicate 

• If a Duplication Fails 

• Restoring from Backup or Duplicate 

• Viewing Reports on Duplications 

• hnporting a Duplicate Volume 

• Rejecting a Mount Request 

• Expiring a Duplicate Volume 
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The Media Duplication Media duplication enables you to make a duplicate set of tape 

Process media automatically after a regular backup session. You can 

then send the original volume offsite and keep the duplicate 
copy onslte for restore purposes. (Eitlier an original or 
duplicate may be used for restore purposes.) 

A duplicate set of media is of tlie same media type and has the 
same tlieoretical size as the original media. Duplicate media are 
also uniquely labeled; tliat Is, a duplicate volume has a different 
volume ID tlian its coixesponding original. 

Duplication of backup media can occur automatically after each 
backup sessioji (unless a trail is set for manual duplication). All 
media that backup creates can be scheduled for duplication. 

Note: You cannot duplicate volumes that are used by 
Hierarchical Storage Management (HSM). 

Duplication of a trail starts after its backup completes. However, 
if backup of a trail requires more than one volume, neither Is 
duplicated until tlie backup of die entire trail completes. 

Media duplication can run when an unrelated backup or restore 
process Is running, altliough backup or restore processes take 
precedence. If a backup or restore activity starts during media 
duplication and only one drive is still available, botli the 
original and duplicate in a current duplication process share 
that drive. If no odier drives are available, duplication is 
suspended until an operation with higher priority completes. 

Older-generation duplicate volumes are purged automatically 
when a trail is configured to use new mode for duplication. 
(Refer to "Starting Duplication" on page 9-5.) These older 
duplicate volumes are purged when the current duplication of 
the original volume completes successfully. Only one allocated 
duplicate volume exists for an original volume. 

Note: 'lire automatic purge feature cannot be disabled. 
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Media Duplication Commands To manage and control media duplication processes, you can 
manage die vmdupd, and vmdup daemons, and use the 
vmdupcfg command. 'Ilie following briefly describes each of 
these; examples of using each are provided later in tliis chapter. 
(Refer to the appropriate man page for detailed information.) 

The vmdupd daemon manages media duplication. This 
daemon, which runs in the background, is pan of tlie normal 
EDM startup process, vmdupd monitors online tape volumes 
that require duplication and starts the vmdupmedia processes 
that perform duplication of those volumes. When run from the 
command line, you can monitor and control vmdupd's actions. 

The vmdup daemon command manages the media duplication 
scheduling queue. You use this command to start or stop 
duplication for a trail that is configured for manual duplication. 
You can also remove duplications from tlie schedule queue 
before diey begin duplication, or reschedule failed duplications. 

Using the vmdupcfg command enables you to view the current 
state of duplication parameters, or modify particular parameters. 
This command also allows you to enable or disable media 
duplication system wide. 



Starting Duplication When starting media duplication, you prepare a backup volume 

for duplication, configure the duplication in append or new 
mode, configure a backup trail for manual or automatic 
duplication, and initiate duplication. 

The following sections describe each of these procedures. 
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Preparing a Backup yolume At the beginning of the backup process, a padded tape label 

for Duplication (a tape label and padding block) is written to an original 

volume, even if duplication is disabled. Tliis helps to ensure 
that all of the original data fits on the duplicate media if the 
duplicate is found to have many l^ad blocks. Tlius, the actual 
data that is written to the duplicate is exactly the same as tliat 
on the original volume. That is, tliere is always a one-to-one 
correspondence between the original volume and the duplicate. 
(The current default pad block is 10 Mb for all tape media.) 

You can control the size of the padding block of an original 
volume at the time a volume is created. For example, you may 
want to change the pad size on new volumes if your volumes 
tend to have a high number of bad blocks. You specify the 
padding block size at the command line using the vmdupcfg 
command witli the optional -tape_pad argument as follows: 

# vmdupcfg -set -tape_pad n 

where n equals the number of blocks. The value of n can range 
from 1 to 50, where 1 = 10 Mb and 50 = 500 Mb; the default 
value is 10. 

Note: The new tape pad size takes effect the next time a 
backup process allocates new media. 

For example, if you set the number of blocks to 4: 

# vmdupcfg -set -tape__pad 4 

You can check the setting with vmdupcfg as shown: 

# vmdupcfg 

Media duplication enabled. 

No automatic media ejection from the library unlt{s). 
Tape pad blocks: 4 
Max concurrent dups: 1 
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Selecting Append Mode or You can configure media duplication for append mode or new 

New Mode mode, as described below. 



Append Mode in append mode (the default), duplication follows the policy 

that the backup procedure uses. 'Iliat is, if the backup appends, 
or adds, data to an existing volume or writes data to a new 
volume, duplication also appends to an existing volume or uses 
a new volume, respectively. 

When appending to an existing duplicate volume for a trail, 
duplication starts from die beginning of the volume but skips 
the previous backup duplications that con-espond to the 
original backup volume. It then adds new backup information 
to the end, as shown in Figure 9-1. 



Figure 9-1 Append Mode: add data for Day 3 after Day 2. 
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In the above example, backup of a trail for Day 3 is appended 
to the original volume; the data for Day 1 and Day 2 is skipped 
and Day 3 is added. Duplication of this original volume follows 
the same policy as tliat for the original; data for Day 3 is 
appended after that of Day 2 on tlie duplicate volume. 

When you use new mode for duplication, a new volume is 
allocated for the duplication even if the backup procedure calls 
foi- appending to its existing backup volume. Using new mode 
duplicates the entire tape each time, from beginning to end. 

In Figure 9-2, data for Days 1, 2, and 3 of a trail's backup exist 
on one original volume. During duplication in new mode, data 
for Day 1 is written on one duplicate volume, data for Days 1 
and 2 is written on another, and data for Days 1, 2, and 3 is 
written on yet another. The duplicate volumes with data for Day 
1 and Days 1 and 2 are now considered older generation 
volumes and are no longer valid. As each duplication completes 
successfully, the previous, older duplicate volume is reallocated 
for re-use. 

Note: It is strongly recommended that you use append 
mode for duplications. When using new mode, the 
time to duplicate the original volume increases as 
more backups are appended to it. 

If it is necessary to use new mode, select the Media tab in die 
Backup Configuration window. In the Duplicate Media section 
of tlie window, select the button that is labeled Use New Media 
for Duplication. 

Note: Be sure tliat new media is available for use in the 
library unit. 
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You configure a backup trail for automatic or manual 
duplication in the Backup Configuration window of the EDM 
GlJl. In this window, you select the Media tab and then click on 
the Duplicate Media button. 

Selecting automatic duplication enables automatic duplication 
of a trail when a backup completes. In the mounted volume 
display area of the Library? Unit Manager (LM) window, an 
application ID of "MD" on the mounted original and duplicate 
volumes indicates tliat duplication is in progress. 

Note: It is recommended tliat you use automatic 

duplication (the default) when duplication is 
enabled. 

Selecting manual duplication in the Backup Configuration 
window enables duplication of a trail if you wish to duplicate 
the media at a later time (refer to "Initiating Manual 
Duplication'' below). 

Note: Refer to "Backup Trailsets" on page B-58 for an 

example of a trail that is configured for duplication. 



Initiating Manual Duplication You initiate manual duplication of an original volume by ti-ail 
at the CLI name at the command line by using the vmdup command with 

the -set and -trail options, and the trail that you wish to 

duplicate: 

# vmdup -set -trail trailname 

An example with output follows: 

# vmdup -set -trail backup_DLT 

Trail backup_DLT scheduled for duplication 

You can also initiate duplication of an original volume by trail 
ID by using the -traillD option and tlie trail ID. To obtain a trail 
ID, run ebreport media; a trail ID appears as a rotation ID in 
the listing. 



Configuring a Trail for 
Duplication 
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# vjndup -set -traillD trailJD 

An example with output follows: 

# viKiv55 -set -traillD 82D82B05 .A9730CA5 . 00000200 . 380491BA 

Trailld 82D82B05 . A9730CA5 . 00000200 . 3804 91BA 
scheduled for duplication 

Note: Ensure that media is available online for duplicate 
volumes. 

Note: Ensure that the original volume is online (not 
offline or olTsite) before initiating duplication. 

You can use the command vmdupd -all to verify that 
duplication was scheduled. This command displays all active, 
suspended, and scheduled duplications. (See also "Verifying the 
Status of a Duplication" below.) 

An example follows: 



# vmdupd -all 

Media duplication daemon started. 
Active Duplications 

Trail: backup^DLT Mode: append Typ 
Orig Vol: A1D7F9BD71812B77 (BDE098) 
Dup Vol: 45D81F75C195EEF0 (ASV891) 
401 Complete Duration: 000 Hrs . 53 
Blocks Copied: 141381 Total Blocks 

No Suspended Duplications found 

No Scheduled Duplications found 



e: DLT tape Status: ACTIVE 

Seq #: 000025 in TLU: atl_3264__0 
Seq #: 000027 in TLU: atl__452_0 
Min. Start Time: 12/31/1999 13:27:16 
to Copy: 350343 



Note: A completed duplication may still appear as Active 
with a completion status of 100% when you check 
its status by using vmdupd -all. This duplication is 
stOl transitioning fi-om an Active state to the 
duplication state of Done. 
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Determining Duplicates of an in the Ubraiy unit Manager window of the EDM GUI, you can 

Original Volume cletemiine wliether a duplicate exists foi- an original backup 

volume, hi the media list (as shown below), you can identify a 
duplicate in a number of ways: 

• The media list icon in the first column indicates a duplicate 
by a double tape graphic 

• "Duplication" appears in the Current Use column if the 
volume is a duplicate 

• hi the Identical To column, the barcode for a duplicate 
volume appears with its original, and vice versa 

Note: Refer lo the I.ibraiy Manager Online Help (Columnis 
tab) for insinictions on adding columns to the 
media list. 
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1 24 volLme displayed, 0 selected, D scheduled 



You can determine the duplicate of an original at the CU by 
using the ebreport media command. This command generates 
a report that lists cuirently allocated volumes. Refer to "Viewing 
Reports on Duplications" on page 9-25, and the ebreport man 
page, lor more information about this command. 
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Note: IF more tlian one libraiy unit of a given media type 
is attached to your EDM, you cannot tell in which 
LU your duplicate media will reside. 

You can also use the evmstat -c command to view a list of all 
catalogued volumes (see the example below). Tlie entries in 
this list identify original and duplicate volumes, and the original 
volume for each duplicate. (Refer to tlie evmstat man page for 
more information about this command.) 



* Mtype Seq/BC Name LU Name Volume Type VolJD Original Vol_ID Generation 

C DLT BNY574 baGkup_DLT offline_0 none 5ED19D47EED28D1C 0 

C DLT BDE133 backup_DLT offline_0 duplicate 48D19D5CCFBF3754 CAD19D501B028C8E 0 

C DLT BDE145 backup_DLT ex_210_0 original CAD19D501B028C8E 0 



Setting the Maximum 
fiumber of Concurrent 
Duplications 



Hie system is configured at startup to mn no more than one 
duplication at a time. This is based on die assumption that 
media duplication has at least two drives available for its use. 
However, you can configure multiple duplications to run 
concun-ently if four or more drives are available. You configure 
concurrent duplications in the Backup Configuration window of 
the EDM GUI, or at tlie command line. 

The number of duplications that you can set is based on the 
total number of drives tliat media duplication can use. For every 
pair of available drives, you can increase the number of 
duplications by 1. For example, witli six available drives you 
can set tliis number to any value from 1 to 3. 
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Configuring Concurrent in the Backup configuration window, select the Server tab. In 

Duplications in the the Duplicate Media section, set the Maximum ConcuiTent 

EDM GUI Duplications from 1 to 10; the default is L 

Note: Do not set the maximum numlDcr of duplications to 
a value that is greater than half the number of 
drives. Otherv.'ise, significant performance degra- 
dation to the duplications occurs as the duplications 
must then share the drives among them. 



Configuring Concurrent At the command line, set the number of concurrent duplications 

Duplications at the CLI by using tlie vmdupcfg command as follows: 

# vmdupcfg -set -max_dups N 

wliere iVis the number of duplications, from 1 to 10. 
For example: 

# vmdupcfg -set -itiax_dups 4 

Confirm your change as follows: 

# vmdupcfg 

Media duplication enabled. 

No automatic media ejection from the library unit{s). 
Tape pad blocks: 1 
Max concurrent dups : 4 

If two separate libraiy units (LUs) are being used in your 
system, set iV based on the number of drives in the system that 
are available for duplication. For example, in a system with a 
two-drive LU and a six-drive LU, you can set iVto 4 if either or 
botli are used for duplication. 
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Note: ]f you set the maximum number of duplications at a 
value that is greater than the number of available 
drives in the system, a warning message appears. 
Tlie message contains the total number of drives for 
a given drive Urpe and the drive t^pe name; for 
example: 

WARNING - The server is configured with 
10 DLT7000 drives. The max_dups 
parameter will be updated to support 6 
duplications. This drive configuration 
will only support 5 duplications. 



Verifying the Status of a You can verify the status of active, suspended, scheduled, and 
Duplication failed duplications at the command line by using the vmdupd 

command. (Refer to the vmdupd man page for more 

information.) 

• vmdupd -all displays all active, suspended, scheduled, and 
failed duplications, as shown in the example belcjw. For 
each duplication status, the following information appears; 

- the trail that is being liacked up 

- duplication mode (new or append) 

- volume t^-'pe 

- duplication status (ACllVE, SUSPENDED, CANCELED, 
SCHEDULED, or FAILED) 

- original volume ID 

- sequence number 

- duplicate volume ID 

- total number of blocks that are to be duplicated 

(Refer to "Viewing Reports on Duplications" on page 9-25 for 
more information about duplication status.) 
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# vmdupd -all 

Media duplication daemon started. 
No Active Duplications found 
No Suspended Duplications found 
No Scheduled Duplications found 
Failed Duplications 

Trail: backup_DLT Mode: append Type: DLT tape Status: CANCELED 
Orig Vol: FBD7 9BDAD25C1C62 (BDE099} Seq #: 000005 in TLD: atl_3264_0 
Dup Vol : None 
Total Blocks to Copy: 12817 

Trail: backup_DLT Mode: append Type: DLT tape Status: CANCELED 
Orig Vol: A8D7969E4D438EE3 (BDE137) Seq #: 000003 in TLU: atl_3264_0 
Dup Vol : None ^ ^ 

Total Blocks to Copy: 75 



If a Duplication Was 
Scheduled for an Offline 

Volume 



If you move offline a vofume that is scheduled for duplication, 
the duplication still appears in the output when you run 
vmdupd -all. If you want to remove the scheduled duplication, 
you must mn vmdupd -cancel to designate it as Failed, and then 
run vmdupd -remove to remove the duplication from the Failed 
queue. 



Manually Disabling and Though media duplication is enabled automatically, you can 
Re-enabling Duplication manually disable and re-enable media duplication system-wide 
at the command line. However, disabling duplication is not 
recommended unless absolutely necessary (for example, if 
duplication of original volumes is not to be performed for any 
volumes in the system at any time). 
Procedures for disabling and re-enabling duplication are 
described below. 

Note: Any configuration values that you set For 

duplication (pad blocks, maximum number of 
duplications) are lost when you disable duplication. 
You must reset them when you re-enable 
duplication if you do not wish to use the default 
values. 
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Disabling Duplication You disable duplication by halting the vmdupd daemon that 

controls media duplication, and then disabling duplication. Any 
duplications that are in progress are also suspended, but are 
completed when duplication is enabled and the vmdupd 
daemon is restarted. 

Use the following procedure at the command line to disable 
media duplication for the entire system: 

1. Run vmdupd -halt to halt the vmdupd daemon. 

2. Verify with llie following command that the daemon no 
longer exists: 

# ps -aef I grep vmdupd | grep -v grep 

The ps command enables you to view information about 
active processes. Refer to the ps man page for more 
information about this command and its options. 

3. Run vmdupcfg -reset to disable duplication. 



RS-Cnabling Duplication The re-enabllng process also involves two steps; you restart the 

vmdupd daemon and tlien enable duplication. Any suspended 
duplications are then completed. 

Use the following procedure to re-enable media duplication for 
the entire system: 

1. Run /usr/epoch/bin/vmdupd & to restart the vmdupd 
daemon. 

2. Verify that the daemon started with the command: 
# ps -aef I grep vmdupd | grep -v grep 

An example follows: 

client :> ps -aef | grep vmdupd | grep -v grep 

root 2424 1 0 09:53:05 pts/2 1:12 /usr/epoch/bin/vni 
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3. -Run vmdupcfg-set to enable duplication; remember that 
using this command resets the duplication parameters back 
to the default values. 

4. Verify the operation by using vmdupcfg with no 
arguments: 

# vmdupcfg 

Media duplication enabled. 

No automatic media ejection from the library unit{s). 
Tape pad blocks: 1 
Max concurrent dups : 1 

Note: You need to reset any values (tape_pad, max_dups) 
that were previously set before duplication was 
disabled. 



Pausing, Resuming, You can temporarily pause duplication in progress at the 

Canceling, or Removing a command line (for example, if it is necessary to allow otlier 
Duplication operations to complete). 

Note: Before pausing, verify with the vmdupd -all 

command that duplication is ACTIVE. 



Pausing Duplication To pause duplication, use the command vmdupd -stop. After 

entering vmdupd -aU again, notice that the state changed from 
ACriX i: lo SrSiM;\I)i;n. 'Ihis shuts down the duplication 
process and \'olLimes are dismounted from drives. In the Library 
I nit Manager ( LM) window, also notice that the application ID 
i)( "MD" disappears from the volumes that are being used for 
duplication. 

Note: Tliis command disables scheduling of all 
duplications system wide. 
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Resuming Duplication To continue a paused duplication, use the command 

vnidup -cont. Verify with vmdupd -all that the state of 
duplication changed from SUSPENDED to ACTIVE (allow a few- 
moments for the state to change). In the Library Unit Manager 
(LM) window, the volumes are remounted. Notice tliat the 
application ID of "MD" reappears on the volumes in use. 



Canceling Duplication you can cancel an active, suspended, or scheduled duplication. 

Canceling the process sets the duplication .state to FAILED. 

Canceling an active duplication shuts down the process; when 
the duplication is rescheduled, the entire volume is duplicated. 

To cancel a duplication, you use the following command: 

# vmdup -cancel -volID <orig volID> 

where orig volID is the ID of the corresponding original volume. 

The resulting output of the canceled duplication is similar to the 
following. Tlie value witliin parentheses is the volume's 
barcode. 

# vmdtip -cancel -volID 7DD7E5CDDCD690DB 

Duplication for volume 7DD7E5CDDCD690DB {AAC009) 
canceled 

If you wish to check on the status of the canceled duplication, 
you can use the vmdupd command, llie duplication status 
should appear as FAILED, as shown: 
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# vmdupd -all 

Media duplication daemon started. 
No Active Duplications found 
No Suspended Duplications found 
No Scheduled Duplications found 
Failed Duplications 

Trail: backup_DLT Mode: append Type: DLT tape Status: FAILED 
Orig Vol: 7DD7E5CDDCD690DB (AAC009) Seq #: 000004 in TLU : de_x7( 
Dup Vol: None 
Total Blocks to Copy: 15445 



Removing a Failed Duplication You can remove a failed duplication from the queue by using 
from the Queue the vmdup -remove command at tlie CLI. Using tliis command 

deallocates all duplicate volumes that are associated with the 
original volume, which makes them available for reuse. 

The vmdupd -remove command also clears the duplication 
flags for the original volume, which removes tlie original 
volume from the failed duplication queue, and removes the 
duplication state of trailed from the original volume. 

If another backup is schediiled for the original volume, tlie 
duplication of that volume is also scheduled. 

Use this command as follows: 

# vmdup -remove -volID original volume ID 

For example, 

# vmdup -remove -volID 5DDC2A1510BOA3DO 

Volume 5DDC2A151DB0A3D0 removed from the failed 
duplication queue. 

You can then use the vmdupd -all command to verify that this 
operation is successful. 
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If a Duplication Fails During media duplication, the duplication is set to FAILED if: 

• you reject a volume request for a specific duplicate volume 
at the beginning of a dupliaition process 

•» you reject a queued request for an available duplicate 
volume (the queued request no longer reappears) 

• a request occurs for mounting and relabeling a duplicate 
volume that is considered "unmountable" (for example, 
barcode mismatch) 

• you cancel a duplication (refer to "Canceling Duplication" 
on page 9-17) 

» a read en'or occurs on tlic original volume 
» a write error occurs on the duplicate volume 

Be sure to reschedule the duplication as soon as possible so 
that duplication of tlie specific volume can resume after backup. 
Othervkise, if the trail supports automatic duplication, 
subsequent backups to that specific trail do not schedule 
duplications automatically until the next rotation. 



If a duplication failed for some reason , you can reschedule it in 
the Library Unit Manager (LM) window of the EDM GUI, or at 
the conmiand line. 

Note: Always check the uses count on tlie duplicate that is 
still mounted in the drive to ensure that it is less 
than the maximum uses for the volume. This 
prevents the volume stains from changing to 
Expired for the mounted volume. (If a mounted 
volume's status changes to Expired, you must 
manually remove the volume from the drive.) 



Rescheduling a Failed 

Duplication 
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R^Cheduling a Failed Duplication in the LM window, click on the Duplications button. Hie Media 
Through the GUI Duplication Control window that appears lists all failed 

duplications. In addition to the Failed status, information for the 
failetl duplication also includes the trail name and sequence and 
bar code numbers for the original and duplicate volumes. 
(Refer to "Viewing Reports on Duplications" on page 9-25 for 
information about rescheduling a failed duplication.) 

To reschedule a duplication, select the volume for duplication 
in the Media Duplication Control window and then click on tlie 
Reschedule button. (Holding the Shift key while selecting 
enables you to select more than one volume at a time.) 
Information for the selected volume then disappears from the 
window. 

(You can also access the Media Duplication Control window in 
the EDM Main window by selecting Duplications in the Media 
pull-down menu, or by selecting a Library Unit in the window, 
clicking on tlie right mouse button , and choosing Duplications 
from the pop-up menu.) 

Note: It is important that failed duplications be 

rescheduled, as no subsequent backups to 
the original are duplicated until rescheduling 
cxcurs and duplication is successRil. 
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Rescheduling a Failed Duplication at When rescheduling a failed duplication at tlie CU, you can view 
the CLI all failed duplications by using tlie vmdupd -all command as 

follows: 

# vmdupd -all 

Media duplication daemon started. 
No Active Duplications found 
No Suspended Duplications found 
No Scheduled Duplications found 
Failed Duplications 

Trail: misk_ms_DLT Mode: append Type; DLT tape Status: FAILE 
Orig Vol: E1D86D2C8219CB14 {BDE145) Seq #: 000018 in TLU: atl_ 
Dup Vol: None 
Total Blocks to Copy: 400 



Then enter the following: 

# vmdup -reschedule -volID volmne_ID 

where i>olume_ID is the original's volume ID. The failed 
duplicate is deallocated and an available volume is selected. 

Following is an example of the resulting output (the barcode, 
if any, appears in parentheses after the volume ID): 

# vmdup -reschedule -volID E1D86D2C8219CB14 

Volume E1D86D2C8219CB14 {BDE145) rescheduled for 

Use tlie vmdupd -all command to verify tliat the duplication is 
scheduled: 
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# vmdupd -all 

Media duplication daemon started. 
No Active Duplications found 
No Suspended Duplications found 
Scheduled Duplications 

Trail: backup_DLT Mode: append Type: DLT tape Status: SCHEDULED 
Orig Vol: E1D86D2C8219CB14 (BDE145) Seq #: 000024 in TLU: atl_3264__0 
Dup Vol: None 
Total Blocks to Copy: 19629 

Note: You cannot reschedule a volume that is already 
scheduled for duplication; otheradse, an en"or 
message appears. You must first cancel the 
duplication by using the command vmdup 
-cancel -<volume_ID> and tlien reschedule. 



ROSCheduling DupiiCStlon of if you tiy to resdiedule duplication of an offline original volume 
an Offline Original Volume at the CLI, a message appears that states that the original is 

offline. For example: 

# vmdup -reschedule -volID <volume ID> 

Cannot schedule duplication for original volume: 
<volume ID> (barcode, if any) , volume is in library 
unit: offline^O 

You must then inject tlie offline volume into the library unit 
before rescheduling it. 
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Rescheduling Duplication of a An occasion may arise in which, for arcliival purposes, you 
Single Volume for Archival want to duplicate a volume of a trail that is not normally 

Purposes scheduled for manual or automatic duplication. 

Before rescheduling the volume for duplication, first run 
ebreport media to find the volume ID of the volume to 
duplicate: 

# ebreport media 

Rotations for Template "default", Trail "backup_DLT" , Primary Trailset 
12/31/1999 18:03:03 Rotation ID: 56D874D8 . 106F916B. 00000200 . 390B91E2, 35 backups 

Media duplication not used 
*Orig Vol: 56D874D8106F916B (BDE132), Seq #: 000026 in TLD: at_452_0, media: DL' 
Orig Vol: 13De74E52C75916D (BDE023), Seq #: 000032 in TLU: at_452__0, m.edia: DLT 



Next, use the vmdup command to reschedule dupliration of 
the selected volume; 

# vmdup -reschedule -volID Kvolume ID> 

Following is an example of tlie resulting output (the barcode, 
if any, appears in parentheses after the volume ID): 

# vmdup -reschedule -volID 56D874D8106F916B 

Volume 56D874D8106F916B {BDE132) rescheduled for 
duplication 

Then, by using the vmdupd -all command you can verify that 
the duplication is scheduled. 
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# vmdupd -all 

Media duplication daemon started. 
No Active Duplications found 
No Suspended Duplications found 
Scheduled Duplications 

Trail: backup_DLT Mode: append Type: DLT tape Status: SCHEDULED 
Orig Vol: 56D87 4D8106F916B {BDE132) Seq #: 000024 in TLU : at_3264__0 
Dup Vol: None 
Total Blocks to Copy: 19629 



Restoring from Backup or 

Duplicate 



Note: An up-todate duplicate implies that no additional 
backups were appended to tlie original since this 
duplicate was completed. Tlierefore, the duplicate 
volume is an exact duplicate of the original 

If the original volume is offline or offsite but an up-to-date 
duplicate volume is physically present in a library unit, the 
duplicate volume is automatically used. 

If botli the original and up-to-date duplicate are offline or 
offsite, processing suspends until appropriate media is injected 
into the libraiy unit. Within the EDM GUI, tlie Volume Request 
window appears, wliich prompts you for the original or 
cun-ent duplicate. You must then load either volume into the 
library unit so that the restore process can use it. 

Note: Tiie duplicate volume is not substituted for the 

original volume during a restore if the original was 
modified since the last duplication. 



When you restore a backup, you can tise either an original 
backup volume or an up-to-diite duplicate volume. If the 
original volume is physically present in a library unit (that is, 
not offline or offsite), the original is automatically used for the 
restore. 
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If an Original Volume is If an original volume in your libraiy unit is defective and a 

Defective valid, current duplicate is available offline, eject the original 

volume so that it is no longer used for restoring files or doing 

additional backups. 



Viewing Reports on you t^m use the ebreport media and ebreport duplicate 

DupliC3tiOnS commands to check the status of duplicate media. The repoi-ts 

that these commands generate are described below. 

(Refer to the ebreport man page for more information.) 



ebreport media Report The report that ebreport media generates reports lists all 

currently allocated volumes by volume ID and barcode (where 
applicable), and identifies whether a volume is an original or a 
duplicate. Also listed is whedier duplication is enabled for a 
rotation of a trail, and if so, how many duplicates were made. 

A sample report is shown: 

# ebreport media 

EDM Backup Media Report for server edm on Dec 31 23: 07 : 40 1999 
Report options : none 

Summary of all media, listed by media rotation groups 

Rotations for Template "usr_bin" , Trail "usr_bin_DLT" , Primary Trailset 

12/31/1999 09:46:51 Rotation ID: A1D7F9BD. 718 12B77 . 00000200 . F206F11B, 104 bac 
Media duplication used on 1 copy 

*Orig Vol: A1D7F9BD71812B77 {BDE098) , Seq #: 000025 in TLU: at_3264_0, media: DLT ta 
Dup Vol: 45D81F75C195EEF0 (ASV891), Seq #: 000027 in TLU: at_452_0, media: DLT tap 
Duplication State Active, Empty, Duplication Date 12/14/1999 13:43: 
Dup Vol: 4DD81EE7477F8BDA (BDE146), Seq #: 000017 in TLU: at_3264_0, media: DLT te 
Duplication State Done, Successful, Duplication Date 12/31/1999 13: 
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!f the trail supports duplication and no currently allocated 
duplicate volume is available for the original, "None" appears 
for duplicate volume information, as shown: 



12/31/1999 23:57:57 Rotation ID : 65D84 98A. FD4 DC69B. 00000200 . 54 0819F4 , 2 backups 

Media duplication used on 1 copy 
*Orig Vol: 65D8498AFD4DC69B (BDE012}, Seq #: 000020 in TLU: at_452_0, media: DLT 
Dup Vol : None 

State Done 



Note: If you see "None" in a report, you should research 
the reason for the entiy Rirther. This may indicate 
that a duplication process did not run coirectly. 

For each rotation of a schedule template, just before tlie 
volumes are listed, one of the following appears on the so'een: 

Media duplication used on 1 copy 

Media duplication not used 

Note: XX'lten duplication is enabled for a trail, the report 
always stales tliat duplication is used. 

The volume state follows the word "State" and appears as 
Scheduled, Active, Suspended, Resuming, Failed, Done, or 
Impoited. 

The duplication status follows the volume status and appears as 
Empt)' or Old (another bacloip was appended to the original 
volume but not duplicated), depending on whether the 
duplicate is valid. (Refer to 'Importing a Duplicate Volume" on 
page 9-29.) 

The duplication volume states are listed in on page 9-28. 
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ebreport duplicate Report The report that ebreport duplicate generates includes tlie 

information that the ebreport media report contains. In 
addition, tlie ebreport duplicate report also provides die 
mode of duplication (append or new), the total number of 
blocks tliat were duplicated, the start and stop times of the 
duplication, the end time of the last duplication, and the 
duplication expiration date. A sample report is shown: 

# ebreport duplicate 

Rotations for Template "usr_bin", Trail "usr_bin_DLT" , Primary Trailset 

12/31/1999 09:46:51 Rotation ID:A1D7F9BD. 71812B77 . 00000200 . F206F11B, 104 backups 

Media duplication used on 1 copy 
Duplication State: Done, Old, Mode: New 

*Orig Vol: A1D7F9BD7 1 812B77 (BDE098) Seq. #: 000025 in TLO : atl_3264_0, media: DLT 
Dup Vol: 40D81EE7477F8BDA (BDE146] Seq. #: 000017 in TLO: atl_3264__0, media: DLT ta 
Total Blocks: 349028 Start Time: 12/22/1999 10:54:26 End Time: 12/22/1999 13:06 
Duration: 001 Mrs. 31 Min., Duplicate Expiration Date: 12/25/1999 

12/31/1999 12:57:57 Rotation ID: 65084 98A. FD4DC69B . 00000200 . 540819F4 , 2 backups 
Media duplication used on 1 copy 

If the trail supports duplication and no currently allocated 
duplicate volume is available for the original, "None" appears 
for duplicate \'olume information, as shown below. 

Note: If you see "None" in a report, you sliould research 
the reason for the entry- further. This may indicate 
that a duplication process did not run correctly. 

Duplication State: Done, Mode: Append 

*Orig Vol: 65D8498AFD4DC69B (BDE012) Seq. #: 000020 in TLU : atl_452_0, media: DLT t 
Dup Vol : None 

Total Blocks: 207 
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Table 9-1 below lists several examples of duplicate volume 
states. 



Table 9-1 Duplicate Volume States 



Volume State Duplication Status Description 



Suspended 
Resuming 

Scheduled 
Imported 



Successful 
Empt>' 



A valid, up-to-date duplicate volume is complete. 

Duplication is complete but no data was written to the 
duplicate volume. 

Another backup was appended to the original volume since 
this duplicate was completed. Therefore, the duplicate is not a 
complete duplicate of the original, 

f)uplication of the backup is in progress, Wackup information 
was appended to the original and was queued for duplication. 
During this time the duplicate shows up as Active, Empty, or 
Active, Old. (Use vmdupd -all to verily.) 

Data was appended to the original backup volume but the 
duplication is in progress. 

Duplication of this volume failed for some reason, or 
duplication was intentionally canceled. Check the detail log 
(,/var/adm/epoch/detail) for more infonnation about the failed 
duplication. Reschedule this duplication. 



Duplication of the backup volui 



ispended. 



A suspended duplication is restarting oi' an appended backup 
is being duplicated and the duplication is starting. 



The backup volume is a candidate for duplication. 

The duplicate volume was impoiled into the EDM and is ready 
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ImpOrtinS S DupllCStS if you import a duplicate volume (using ebimport), ebreport 

VOlUinS media reports the status as "Not started, empty," which is 

erroneous. Tliis status is corrected when die dupHcate volume is 

appended to. 

Note: The duplicate volume, when imported, is not 

substituted for tlie original volume if the original 
was mcxlified since the last duplication. 



Importing a Duplicate Volume if you import a duplicate before the original, a volume catalog 
before the Original entiy is also created for the original. 

If tlie original is imported: 

1 . A dialog asks if you want to delete the existing entry with 
the same volume ID. You should answer Yes. 

The first entiy for the original still appears; a second, uncat- 
aloged volume also appears in the same drive. 

2. Close the Library Unit Manage]' window. 

3. Click on Volumes to reopen it. 

Now only the uncataloged volume is in the drive and the 
first entry for the original volume is gone. 

4. Now import the uncataloged volume again. 



Rejecting a Mount When you reject a mount request tlirough the Media Request 

Request window, the scheduled duplication is set to Failed to prevent 

the duplication from being recursive. ITiis Failed status appears 
in the detail log. (See "Log File Rotation and Archival" on page 
15-4.) System monitoring also flags this status. (See EDM System 
Monitoring Report for more infomiation.) 
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You should reschedule a failed duplication by selecting it in the 
Duplications window, or by using vmdup -reschedule at the 
command line. (See "Viewing Reports on Duplications" on page 
9-25.) 

Note: It is important that failed duplications be 

rescheduled, as no subsequent backups to the 
original are duplicated until rescheduling occurs 
and duplication is successful. 



Expiring a Duplicate You can expire a duplicate volume at any time before or at the 

Volume same time you expire an original volume. (The original volume 

should be taken offsite rather than tlie duplicate because the 
expiration period of an original volume can be longer tlian the 
dviplicale.) 

In riie Media tab of the Backup Configuration window, click on 
the Expiration Options button. In the Media Expirations 
window til at appears, set the expiration period in years, 
months, or days. Then click on Apply. 

Note: If you attempt to set the expiration date of a 

duplicate after tliat of its original volume, an error 
message appears. You must specify a new 
expiration date before you can continue. 

To expire a duplicate volume at the command line, use the 
ebexpire command. This command enables you to expire 
original and duplicate volumes as well as saveset records and 
backup catalogs. (Refer to the ebexpire man page for more 
information.) 

To expire a duplicate volume, enter the following; 
# ebexpire -d -expire -purge 

The -d option specifies that a duplicate is to be expired. 
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Viewing Duplicate Expiration you can use either of two commands at the command line to 
Dates view duplicate expiration dates: 

1. Using the command ebreport history -expire_times lists 

all expire times for media, catalogs, duplicate media, and 

saveseLs. An example follows: 

***' Work Items for Template dlt_dup_2, Primary Trailset **** 
**ltem "dup:/home/clienl_2" for client "xyz" 



Time 


Lvl ID 


Status 


Entries 


Cat_Exp 


Dup_Exp 


SS_Exp 


Med_Exp Rcvr 


12/04/99 14:13 


9 72306582.345F741C 


complete 


412 


12/05/99 


12/05/00 


03/05/00 


03/05/00 r 


12/04/9913:27 


9 72306582,345F6924 


delta 


0 


12/05/99 


nodup 


03/05/00 


03/05/00 


12/04/9911:19 


9 72306582,345F4B50 


complete 


0 


12/05/99 


01/05/00 


03/05/00 


03/05/00 


12/04/99 10:59 


9 72306582,345F46B8 


complete 


0 


12/05/99 


expired 


03/05/00 


03/05/00 


12/04/9910:45 


9 72306582,345F435B 


delta 


0 


12/05/99 


no dup 


03/05/00 


03/05/00 


12/30/99 12:57 


9 72306582.3458CAF6 


complete 


0 


12/31/99 


01/05/00 


03/30/00 


03/05/00 



2, Using the command ebexpire -check scans tlie saveset 
database and lists the current state of the selected backup 
resources, including the stams of duplications. An example 
follows: 



72306582. 345F741C: media state is 

72306582. 345F741C: saveset state 

72306582. 345F6924 : catalog state 

72306582. 345F6924: duplicate stat 

72306582. 345F435B: media state is 

72306582. 345F435B: saveset state 

72306582. 3458CAF6: catalog state 

72306582. 3458CAF6: duplicate stat 



"onsite", expiring on 12/05/99 14:1 
is "active", expiring on 12/05/99 14 
is "delta", expiring on 12/05/99 13: 
e is "exists", expiring on 12/05/99 

"onsite", expiring on 12/05/99 10:4 
is "active", expiring on 12/05/99 IC 
is "delta", expiring on 12/05/99 12: 
e is "expired" 
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To keep your system working smootMy, you must monitor disk 
space and catalogs, and petform some system maintenance. 
Although EDM Backup soltware has commands and scripts to 
control disk space usage, you should also monitor it 
periodically. 

Tliis chapter covers the following topics: 

• Expiration of Backups and Catalogs 

• Filesystem Cleanup Script 

• Magnetic Disk Capacity' 

• Managing Disk Space 
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Expiration of Backups and On occasion, you need to expire old backups and backup 
GataloyS catalogs. Expii-lng backups frees up storage media for reuse as 

well as the disk space that theii* coiTesponding backup catalogs 
use on the server. Expiring additional catalogs of older backups 
can free up additional needed disk space on the server. 

EDM Backup software creates a backup catalog each time it 
backs up a work item. The backup catalog identifies a backup 
at the file level by recording die names and attributes of each 
file in tlie work item at the time of the backup. It also keeps 
track of die location of backed up data for each file tliat was 
selected for backup. You need the backup catalog when 
restoring files. 

Catalogs are stored online on the server and can grow to be 
quite large. To maintain sufficient magnetic disk space you must 
expii-e the catalogs after a fixed period, perhaps quite earlier 
than you wish to expire the backups themselves. 

You can expire a catalog and still restore data from its con-e- 
sponding backup if neces.sary, liecause unprocessed catalogs 
are also stored directly on the backup tapes along with tlie 
backup data. If you need to access an old backup, you can 
recreate the catalogs from these raw, unprocessed catalogs on 
the media by using the ebimport command. 

For each backup of a work item, the sei-ver also creates an 
online saveset as well as the backup catalog. The savesel record 
contains information about an entire backup, for example, its 
start time, the media trail that the backup program used to write 
the backup data, and the expiration periods. The saveset 
records do not occupy much space. 



EDM Software Reference 



10-3 



Expiration of Backups and Catalogs 



Choosing Expiration Periods The Media Expirations pop-up window enables you to set fixed 
periods for expiration of backup data, catalogs, and the saveset 
record. You reach this pop-up window dirough tlie Media tab of 
the Backup Configuration window. 

You should change the timing for expiring catalogs, backups, 
and savesets according to tliese ailes: 

• Backup period must be greater than twice the rotation 
period because incremental backups on one tape in a 
media set (trailset) assume access to the previous incre- 
mentals and most recent full backups on previous tapes in 
that media set. 

Note: It is important for all of these expiration periods to 
be greater than twice the rotation period. The 
reason for this is that you need a full backup and 
sulDsequeni delui catalog files to reconstruct your 
system for disaster recover)^ It is especially 
important if you automate deletion of expired 
backups in crontab. 

» Catalog period must be greater than twice die rotation 
period, but it can be less tlian the backup period. 

• Saveset period must equal tlie backup period unless you 
choose never to expire the backup period. In no case can it 
be less than twice the rotation period. 

You can change tlie expiration periods at any time. Any 
changes to tlie expiration periods take effect the next time 
ebbackup runs, either from an entiy in root's crontab file or 
manually by t>?ping die command ebbackup from the 
command line. 

# /usr/epoch/EB/bin/ebbackup 
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Running Expiration After a backup is eligible for expiration, you can delete it from 

your system, either automatically by running die command 
ebexpire -purge in root's crontab, or manually from tlie 
command line. Use the -purge option with the ebexpire 
command when you want to delete expired catalogs. 
# /iisr/epoch/KB/bin/ebexpire -purge 

The ebexpire -purge command identifies backup data, 
catalogs, and saveset records that are eligible for expiration 
because they exceeded their duration period as set in the 
backup configuration. (Refer to the ebexpire man page for 
more information about this command.) 



Filesystem Cleanup Script Tiy to keep the number of old and unneeded files to a 

minimum on your system to conser\'e space for tlie backup 
catalogs. Tlie cleanup script epcleanup simplifies the cleanup 
of your filesystem by removing unneeded or old files from tmp, 
crash, and adm subdirectories. 

The system is automatically configured to execute the 
epcleanup script from cron with the default settings. The line 
in root's crontab file that specifies the epcleanup script is: 

30 8 * * * /usr/epoch/llb/epcleanup > /dev/null 

2>&1 

If you want to override any of the defaults, specify the option 
name and the new value in the crontab file. For example, if you 
want to cliange the number of days to expire unmodified log 
files from 14 days (tlie default) to 10 days you enter: 

30 8 * * * /usr/epoch/lib/epcleanup -log 10 > 
/dev/null 2>&1 
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Magnetic Disk Capacity You must know your system's catalog capacity to be able to 
configure your site for optimal performance. 

EDM Backup software consumes magnetic disk space based on 
the total nimiber of files to back up. In addition, disk space 
consumption is affected by the rotation period (the number of 
days betv.'een level 0 backups), tlie expiration period for 
catalogs, the percentage of files that change on a daily basis, 
and the average catalog size per file. 

The calculations in this section assume tliat: 

• the system is used as a backup server only. 

• five percent of the files are modified each day: this affects 
incremental backups (see "Calculating Actual Daily File 
Changes" on page 10-7). 

• catalog size averages 200 bytes per file. 

• catalog rec|uirements for database backup are small. 



Keep in mind that tlie minimiim keep catalog period must be at 
least twice that of the rotation period to ensure that the catalog 
is relieved of its dependencies. The system defaults are a 
rotation period of 1 4 days and a keep catalog period of one 
month. 



Table 10-1 Minimum Keep Catalog Period (Days) 





Rotation Period 




7 Days 


14 Days 


28 Days 


14 


28 


56 



Rotation and Keep Catalog 
Periods 
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Table 10-2 shows the maximum number of days diat you can 
use for the keep catalog period for a 25.2 GB catalog 
subsystems as you vaiy the number of files that you back up 
and the rotation period. 

Pick the table tliat matches the catalog disk size that you have. 
Then select the number of files to back up. You can then refine 
the suitable rotation j^eriod and keep catalog policy. 

As long as you are well within the maximum limit of files, you 
are free to adjust rotation and keep catalog periods up and 
down. As you approach tlie upper limit of files, you run into 
some consti-aints, as noted in Table 10-2. 



25.2 GB Catalog Subsystem: Max. Keep Catalog Period (Days) 



Number of 

Files 
(Millions) 


7 Days 


Rotation Period 
14 Days 


28 Days 


1 


470 


745 


1045 


2 


235 


370 


520 


3 


155 


245 


350 


4 


115 


185 


260 


5 


95 


150 


210 


6 


80 


125 


175 


7 


65 


105 


150 


8 


60 


90 


130 


9 


50 


80 


115 
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Table 10-2 25.2 GB Catalog Subsystem: Max. Keep Catalog Period (Days) 





Rotation Period 


10 


45 


75 


105 


12 


40 


60 


85 


14 


35 


55 


75 


16 


30 


50 


70 


19 


25 


40 


56 


23 


20 


30 


<56^ 


31 


15 


< 28^ 


< 56^ 



1. Noi allow -able Ix'caii.se lilt niaxiimini i,s less than the minimum ol 
2x the rotation period. 



Calculating Actual Daily File 'lable 10-1 and Table 10-2 above assume that five percent of the 
Changes files are modified each day, By looking at a backup history 

report, you can calculate the actual number of files that change 

each day at your site. 

This affects the incremental backups. If the actual percentage is 
less, additional files can be backed up. If the actual percentage 
is more, fewer files can be backed up. 

You must wait until EDM Backvip has been running for one 
rotation period before you can generate enough information to 
detemiine the number of daily file changes. 
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The catalogs for incremental backups are consolidated to 
reduce storage space on the server. All but die most recent 
incremental backup catalog are turned into deltas, which list 
only backup files that diifer from those tliat are listed in subse- 
quent catalogs. 

Note: If" you custom schedule an explicit incremental 

backup (level 1-8), by default, tlie catalogs for these 
backups are not consolidated. You can change the 
backup catalog dell a level field in the Backup 
Configuration window from 9 to tlie lowest integer 
level for which you want consolidated catalogs. 

You must j-eview tiie number of entries in a delta catalog to 
determine your daily changed file rate. A delta catalog contains 
only tlie information that differs from tlie subsequent catalog 
files. Tlie number of entries in a delta catalog represent the 
number of files that were changed during the time between the 
backup that delta represents and the subsequent backup. Thus, 
the size of a delta catalog represents a measure of how many 
files were changed during a backup. 

Run a backup repoit (ebreport backup) to display the number 
of files or directories (entries) in each backup catalog, 
l^igure 10-1 illustrates a report diat was produced widi the 
ebreport backup command, and specified with the -since 
option and a date. 'Ilie report shows the type of backxip catalog 
that was created on this date, and the number of file entries. 
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Figure 10-1 



ebreport backup -since Report 



EDM Backup Backup Report for server adam at Oct 24 13:44:05 1998 
Report options: -since 9/15/98 



Template 
default, 



■ary/Alt 
ary: pr 



ate: Trailset name 



Work itei 
Catalog 



Level Start time Tii 



,sed BackupFiles\bad Si 



adam: / 
MB Unso, 
adam: / 
MB Comp 
adam: / 
Delta 



9/23/98 19:33:03 0:12:22 Completed2695\ 0214 



9/22/98 19:42:24 



9/21/98 18:14:37 



L3:42 CDmpleted926\0115. 



11:24 Completed234\00, 0 ! 



0 9/21/98 15:44:04 0:43:48 Completed26720\ 0 

To determine the number of files that are backed up each day, 
run a backup histoiy report for a complete rotation period, not 
including the last backup run. For example: 
emc# ebreport history -since 9/6/98 -until 9/19/98 

This command produces a report that covers a 14-day rotation 
period (refer to tlie ebreport man pages for more information). 
The command output provides a line for each backup of each 
work item, which shows the catalog t>pe and the number of 
entries in the backup catalog. 



For example, you can view a report that contains 1: 
similar to those in Figure 10-2. 



s that are 
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Figure 10-2 ebreport history -since -until Report 

Backup History Report for server atlasl on Nov 20 16:06:15 1997 
**** Work Items for Template cad-all, Primary Trailset **** 
**Item "cad5-all" 
TiitieLvlIDStatusEntriesExpire 

1/ 7/97 20:010C005531B.296A4F13complete317661/ 6/98 
1/ 6/97 20:0l9C005531B.296A32E9delta39431/ 5/98 

Backup Status (delta or complete) 1 



M3n30in9 Disk SpSCB To keep your EDM system working smoothly, you must monitor 

your magnetic disk space. Tliis section describes several ways 
to do this. 



Distributing Catalogs After you run EDM Backup software for awliile, you must split 

the backup catalogs proportionately among tlie available space 
on each disk. EDM Backup software creates catalogs for each 
backup to track the file data in the backup. Initially, EDM 
Backup software places all backup catalogs in a single partition 
under the directoiy (or symlink) /usr/epoch/EB/catalogs. 

The installation procedure creates the directory 
/usr/epoch/EB/catalogs, In the catalogs directoiy each work 
item has one subdirectory - named for that work item. EDM 
Backup places all catalogs produced for that work item in that 
subdirectory, even if the work item is backed up through 
multiple templates and trailsets. 
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Note: You must keep the catalogs on disks that are local 
to t!ie backup sender, not on an NFS-mounted 
filesystem. 

To split the backup catalogs among die disk paititions, use the 
following procedure: 

1. Run ebbackup until eveiy work item had at least one 
successful backup tlirougli each of the configured schedule 
templates and trailsets (media sets). 

Use the ebreport history command to determine that all 
work items had a successful backup. For information on 
using this command, see the ebreport man page. 

2. Divide tlie work items into one group per disk partition so 
that the total number of catalog entries in each group is in 
proportion to the size of tlie partitions. You can determine 
catalog entries per group from the ebreport history report 
output. 

To determine the number of catalog entries in a work item, 
run the ebreport history command. For each work item, 
add the number of entries from the most recent complete 
catalog for eveiy template and trailset. Tliis sum is tJie size 
of the backup catalogs that EDM Backup places in the work 
item's directory during a rotation period. 

For example, consider a site tliat has 50 work items of the 
same size (CADI through CAD50) and tliree available disk 
partitions for backup catalogs. Two of the disk partitions 
have 900 MB of free disk space and the third disk partition 
has 400 MB. To divide the total catalog entries proportion- 
ately to the ratio of available disk space, the site places 21 
work items on each of the 900 MB paititions, and eight 
work items on tlie 400 MB partition. Figure 10-3 below 
illustrates lliis distribution. 
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/data1 
300 MB 




/home 
400 MB 



21 Work Items 21 Work Items 8 Work Items 

3. Move the individual work item entries for each group of 
work items onto the target disk partition. 

Note: Do not move a work item directory while backups 
are running or while catalogs are being processed. 

For example, assume that /usr/epoch/EB/catalogs is a 
symbolic linl< to /home/EB/catalogs and tliat all catalogs 
were initially on the /home partition in that directory. 
To move the work items cad 10 dirough cad20 from 
/home/EB/catalogs on the disk partition /home to the disk 
partition /data] , move the individual subdirectories for each 
of these work items from /home/EB/catalogs to 
/data 1 /EB/catalogs , 

For example, using the Bourne shell, type: 
edm# mkdir /datal/EB 
edm# mkdir /datal/EB/catalogs 
edm# cd /usr/epoch/EB/catalogs 

edml sh 

# for wi in oadl? cad20; do 

> tar of - $wi j (od /datal/EB/catalogs; tar xf -) 

> rm -fr $wi 

> In -s /datal/EB/catalogs/$wi . 

> exit 

4. Monitor the storage usage of the partitions. If one partition 
fills up, move the work item subdirectories to the other 
partitions to keep the proportions balanced. 



10-13 



Managing Disk Space 

Do not move a VA'^ork item directoiy wliile EDM Backup is 
running or while catalogs are being processed. Always 
make sure that /usr/epoclvEB/catalogs has a symbolic link 
to the catalogs in the work item directory. Also, you must 
keep catalogs on disks tliat are local to tlie server. For 
example, catalogs must be on a local filesystem and not on 
an NFS mounted filesystem. 



Reclaiming Magnetic Disk if you do not have HSM, when your magnetic disks fill to 

Space capacity, your backups cannot complete successfully. You 

know that you exceeded magnetic disk capacity on your system 
when: 

• you see numerous messages similar to: 

edm: /home: file system full 

• you see numerous messages that backups have failed. 

• the df command shows that one or more of tlie local 
filesyslems used over 100 percent of its magnetic disk 
space. 



Manually Expire Unneeded Catalogs To create space on your disks and to get backups running 
again, use the following procedure: 

1. Run tlie ebcatclean command to expire unneeded catalog 
related files. 

- If running this command gives you enough magnetic 
disk space to operate, you can stop at tills point. 

- If running tliis command does not provide enough disk 
space to operate, continue with the following steps to 
provide additional space. 

2. Run ebreport history to see the state of all backup 
catalogs. You want tc:i ensure a complete catalog to support 
the delta catalogs you save. 
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3. Choose a date for expiring backup catalogs. Do not expire 
up to within two times tlie rotation period. 

For example, if the rotation period for the specified 
schedule template is 2 weeks, make sure that the -until 
date (in ebexpire in the next step) is at least 4 weeks 
plus one day ago. 

4. Run ebexpire with the -c switch (to expire tlie backup 
catalogs without expiring their backups), and the options 
-purge, -template, -since, and -untU for the specified 
schedule template during the specified dates. 

CAUTION: If you do not specify the -c option, you will 
also expire the backup data and the saveset 
record, wtilch means that the backup is 
completely unrecoverable. 

If you expire the backup catalogs without expiring theii* 
backup, you will still be able to restore your data. Unprocessed 
catalogs are stored on tlie backup tapes. You can bring the 
catalogs online with ebimport and then restore the data. 



The default configuration places a relational database on the 
/usr filesystem. If that filesystem fills up, and you cannot 
identify any files to delete or relocate, you can tiy one of the 
following: 

• Rebooting to free any space that may have been used by 
dead processes to hold open deleted files 

• Expiring backup media and relocating the database to a 
filesystem other tlian /usr 

• Increasing die size of the /usr filesystem 

If necessary, contact customer service for assistance. 
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Changing the Automatic 
Cleanup Script Defaults 



Tiy to keep the number of old and vinneeded files to a 
minimum on your system to conserve space for the backup 
catalogs. Hie cleanup script epcleanup simplifies the cleanup 
of youi" filesystem by removing unneeded or old files from 
/usr/epoch/tmp, /'usr/epoch/adm, and /usr/epoch/etc. 

The system is automatically configured to execute the 
epcleanup script from cron with the default settings, 'lite line 
in root's crontab file tliat specifies die epcleanup script is: 

* /usr/epoch/lib/epcleanup > /dev/null 2>&1 

If you want to override any of the defaults, specify the option 
name and the new value in the crontab file. For example, if you 
want to change the number of days to expire unmodified log 
files from 14 days (tlie default) to 10 days you enter: 

/usr/epoch/lib/epcleanup -log 10 > /dev/null 2>sl 
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EDM Backup widi HSM Option and EDM Migration client 
software extend filesyslem space by migrating file data on 
magnetic disks out to optical disks, magnetic tapes, or even 
otlier magnetic disks, which creates a much larger virtual 
filesystem. All files, even those that are staged out, appear to the 
user to be resident on the local magnetic disk. 

EDM Backup witli HSM Option software provides HSM for the 
local server. EDM Migration client soft^A'are extends HSM 
support to network clients. To enable nefi^'ork migration, you 
must configure HSM on both the EDM and the network clients. 

This chapter introduces some basic migration terms and 
concepts that provide you with background information for 
performing tasks. 

These concepts include: 

• When Files Stage In and Out 

• Filesystem Configuration and Maintenance 

• File Control Properties 

• Compaction of Staging Media 
» Compacting Baseline Media 
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• Migration Repoits 

• Baseline Backup 

• Restaging Data 

• Backup Completeness 



When Files Stage In and There is a limitation of a maximum of 2GB minus 1KB for the 
Out size of files to be staged out or staged in. 

A file is staged out: 

• as part of nightly system maintenance. 'J his is called 
periodic stage out because the staging occurs on a schedule 
(see Figure 11-1). You set up nightly staging mns to reduce 
disk utilization to a predetermined level, called the low 
watermark (LWM). You can set up periodic staging runs 
through root's crontab file. 

• during daily system operation when magnetic disk space 
usage reaches a predetermined level called the high 
watermark (H^/M), or when the iilesystem runs out of disk 
space. Tliis is called event-driven or demmzd stage out 
because it is triggered by a growth in disk usage. 

• in response to a user's request. Users can explicitly stage 
out files with the emst^e command and stage in files with 
the embsi command. 

HSM stages a file back in when: 

• the staged -out file is read, or 

• the staged-out file is modified 

When a user reads a staged-out file, migration locates the file 
and stages it in. At tliis point, the file is considered prestaged - 
that is, the file resides on magnetic disk and on the staging 
media. Migration may later free the local magnetic storage for 
this file, without having to repeat the stage out process. 
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When a user modifies a staged-oiit file, migration stages in the 
file and tlien deletes tlie staged-out version. If migration later 
needs to reclaim magnetic storage, it must stage out tliis file 
again. 

Figure 11-1 shows event-driven and periodic staging over a 
imir-day period. 



Figure 11-1 Staging Out File 



Event-driven Stage Out 




Filesystem Configuration Configuring HSM is a matter of determining how you can best 

and Maintenance tune your filesystems so that tlie most active files are readily 

accessible. This section discusses several basic concepts that are 
pertinent to configuration, including; 
• staging templates and staging trails 



EDM Software Reference 



Basic HSM Concepts 



• bitfiles and client stores 

• watermarks 

• periodic staging and filesystem delay 



Staging TeinplatBS and a staging template defines default values for the filesystems that 

Staging Trails stage to a particular trail of optical disks or tapes, or in tlie case 

of network migration, a particular client store on the server. 

These default values include: 

• template name 

• trail type (EO, DLT, netvv'ork, etc.) 

• volume availabilit}' (restricted or unrestiictcd), which 
specifies how volumes that belong to this template can be 
reused after tliey are compacted. Restricted vo\ux-ne.s can be 
reallocated only to the same template. 

• self-describing media enable/disable 

A staging template can also define configuration values such as 
Vi'atermarks and a delay factor. Staging templates exist for 
filesystems on tlie migration server and for filesystems on 
network clients. 

When files on tlie migration seiver are staged out, they are 
written to a staging trail . Initially, a staging trail consists of a 
single side of an optical disk or a magnetic tape. Over time, a 
staging trail can gi'ow to include several optical disks or 
magnetic tapes. The piece of media that is currently being 
staged to is called die staging trail's current staging volume fsee 
Figure 11-2). Staging trails usually share the same name as the 
staging template. 

When the current volume is full, the Media Requests window- 
tells you to add a new, blank volume to the staging trail. 
Eventually, this volume fills up as well, and the process is 
repeated. Over time, this process builds up a trail of staged-out 
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files for all of the ftlesystems that are assigned to a template. 
(Refer to tlie section on labeling Volumes for information on 
allocating a volume to the staging trail.) 



Figure 11-2 Staging Templates and Associated Filesystems 

/eng filesystem Staging Template Engineering Staging Trail 




Current Staging Volume 



/doc filesystem Staging Template Documentation Staging Trail 




Current Staging Volume 



Deciding How Many Staging Depending on your site's usage patterns and needs, you can 

Templates to Create assign all filesystems to a single staging template or assign 

certain filesystems to tJieir own staging templates. The simplest 
way to set up staging is to group your filesystems into the 
fewest number of staging templates as possible. This has several 
advantages: 

• It directs all of your files to a limited number of staging 
volumes. Tfils reduces tlie number of staging volumes that 
need to be moved in and out of library units. When a user 
requests a staged-out file, there is a greater likelihood tliat 
the file resides on the volume that is already in the drive. 

• It reduces competition for staging devices. If multiple 
filesystems begin to stage out at the same time, they can 
compete with each other for access to staging devices, 
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leading to a phenomenon called thrashing, where die 
system must repeatedly swap media in and out of drives. 
Sliaring a template prevents this from happening. 

However, there are cases wlien it is advantageous, even 
necessary, to create multiple staging templates: 

• When you stage files of widely differing sizes. You can 
reduce the number of mount faults for tlie smaller files if 
you keep very large files on a separate staging trail. 

• When your site lias different access patterns (for example, 
archival vs. working data). Archival data should be staged 
separately from working data. 

• When you want filesysiems that are separate on magnetic 
disks to also be separate on staging media. 

• When you charge groups for the costs of storage media 
and/or storage space. To keep track of costs, you can create 
staging templates for each business group and charge tliem 
separately. 

•> When your site expects to expand to multiple senders and 
move some of the data to a new sei-ver. In this case, a 
separate staging template for each anticipated sei-ver 
simplifies moving the data. 



Bitfiles and Client Stores EDM Migration client software is responsible for the movement 

of files between network migration clients and the migration 
server. EDM Migi-ation automatically maintains the relationship 
between local storage on the client system and .server storage, 
and keeps track of all file data independent of its location. 
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Figure 11-3 



Client Stores 

o 

BItftles migrate from network cli- 
ents to client stores on the migra- 
tion server 



© 

BItflles migrate from client 
stores to staging trail 



-11 


4: 


-1\ 





Client 2 


4: 


-1\ 





Client 2 Store 



Staging Trail 

m 



what EDM Migration client software actually stages is a bitfile - 
an uninreipreted bit array. A single bitfile holds the contents of 
a single client file. Bitfiles are staged to the migration sei-ver 
wliere they are kept in permanent administrative groupings 
called client stores. Each client system owns one or more client 
stores on the server. Otlier clients may be permitted to read 
these bitfiles, but only the owner client can create or delete the 
bitfiles. 

Every client store is associated witli a store ID, which uniquely 
identifies it on the network. 



Deciding How Many Client Stores to A client store can reside witliin any migration-enabled 
Create filesystem on the migration server. Client stores can all be 

grouped into a single filesystem on the migration server or 
spread out among several ftlesystems. If a network client 
contains several stageable filesy stems, you c^n stage all of the 
filesystems to a single store on the migration server 
(Figure 11-4, example 1); you can stage each filesystem to its 
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/eng filesystem I 
/docfilesystem J 



own store within the same filesystem on the migration server 
(Figure 11-4, example 2); or you can stage each filesystem to its 
own store within its own filesystem on the migration server 
(Figure 11-4, example 3). 



Client Store Configurations 

Migration Server 
/datal 

o I 



/clienti store 



Client filesystems stage to single 
store on migration Uleserver 



Client filesystems stage to ttieir own 
stores within same filesystem on 
migration fileserver 



/eng_store /doc_store 



Client flesystems stage to their 
own stores within their own filesys- 
tems on migration fileserver 



/eng_store /doc_store 



As a general rule, the simplest configuration appears in 
Figure 11-4, example 1, where all of a client's filesystems stage 
to a single store on tlie server. If you have three network clients, 
for example, you would only need thi-ee client stores, one for 
each client. All of the stores would reside witliin the same 
filesystem on the migration sender. 
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However, there are cases where it would be advantageous, or 
even necessaiy, to distribute the client stores across filesystems. 
In fact, most of the reasons for creating multiple staging 
templates (see "Deciding How Many Staging Templates to 
Create" on page 11-5) are also taie for client stores. In addition: 

• If a client filesystem consists of a large number of small 
files, it should stage to a store in its own filesystem. 
Otherwise, it could cause a filesystem on the server to grow 
beyond the limit of one million files. 

• If you expect there may be a future need to move a client 
filesystem to another client, you should have that filesystem 
stage to its own store. This simplifies the move because two 
clients cannot stage to the same store. 



Preventing Redundant Backup of If migration client stores are being backed up fi-om the server, 
EDM Migration Client Data tliere is no need to back up the corresponding data on the 

client itself. Use the Backup/HSM tag to prevent migration client 
data from being backed up redundantly. 

The Baclaip/HSM tag is used to update the backupdates file 
(/usr/epoch/etc,4)ackupdates). When a backup begins for a 
sei-ver work item that has a Backup/HSM tag, a time stamp is 
entered in the backupdates file. Before a migration client is 
backed up, the backupdates file is checked. If a file exists on 
the client that is newer than the client store's work item date 
listed in backupdates, the file is backed up. 

From tlie EDM configuration interface, you set the tag's value in 
two places: Backup configuration and HSM configuration. 

When you define the work item that backs up the client store 
filesystem on tlie EDM (Backup Configuration window^ Work 
Item tiib, Work Item options, HSM Options), enter an identifier 
in the Backup/HSM Tag field. EMC recommends that you use 
the work item name for the tag. 'The name must be unicjue 
across all work items that back up the EDM's files. 
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In the HSM configuration window, Client tab, select the tag that 
you entered in backup configuration for the work item that 
backs up the store. 

If you set the tag from the command line (the emsmks 
command), note that the tag must match exactly the 
backup/HSM tag name specified in the definition of the work 
item. 



When a magnetic disk becomes 100% full, the system logs a 
"filesyslem full" message via syslt^d. By default the message is 
displayed on the console and recorded in the system log file. 
Being full should be a transient condition for stageable 
filesystems. Because files are staged out when usage reaches 
the liigh watermark, stageable filesystems should rarely fill up. 



Migration keeps disk space utilization between user-config- 
urable usage levels called watermarks. Watermarks are 
diresholds that trigger a migration response. Watermarks are 
expressed as percentages of a filesystem's total disk space, 
minus the space that some systems withhold from ordinary' 
users. 'The three watermarks are: 

• High Watermark (imM) 

• Low Watermark (LWM) 

• Prestage Watermark (PSWM) 

To understand how \vatemiarks regulate file migration consider 
the following example. Assume you have recently installed your 
migration server and your filesystems still have significant 
amounts of free space. When users add enough files to cause 
the usage level to exceed the PSWM, the nightly periodic 
staging run (set up automatically) will stage files out to the 
staging media, without freeing any space from tlie magnetic 
disk. This is called prestaging fsee Figure 11-5). Because the 
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prestaged files still reside on magnetic disk, users can access 
them quickly. II" filesystem usage rises dj-amatically, migration 
can simply remove the magnetic images of these prestaged files. 



Filesystem Exceeds PSWM 



Magnetic 



Magnetic 




e level exceeds PSWM. 



No change in usage level. 



When your users add enough files to cause the usage level to 
exceed the UHM (88% full), die nightly staging run stages out 
enough files to bring usage down to the LWM (see Figure 11-6). 
To do this, migration actually moves files from magnetic disk to 
secondary storage. In addition, migration prestages files down 
to the PSWM. 
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Figure 11-6 



Filesystem Exceeds LWM 

Staging Media 




Usage level reduced to LWM. 



When your users add enough files to cause the usage level to 
exceed the HWM (95% full), migration triggers a demand 
staging run, that is, migration immediately stages out enough 
files to bring usage down to the IWM (see Figure 11-7). Again, 
migration actually moves files from magnetic disk to secondaiy 
storage and prestages files down to the PSWM. 




Usage level exceeds HWM. 

o 



Filesystem Exceeds HWM 

Staging Media 



Demand staging run stages down to 
LWM and prestages down to PSWM. 



Magnetic 



Usage level reduced to LWM. 
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Generally speaking, once you have enough files to fill youi* 
magnetic disks, your goal is to keep filesystems in the green 
zone, that is, betw^een the low and high watermarks. A key 
decision, then, is how large to make the green zone, 'ilie 
optima] size of the green zone depends on your filesystem's 
usage patterns. 

Table 11-1 shows the watermarks for a 1000 MB filesystem. On 
this filesystem, stage-outs begin when disk utilization reaches 
95% capacity, or 950 MB; stage-outs stop when disk utilization 
falls to 88% capacity, or 880 MB; and migration preslages 
another 80 MB until disk utilization falls to 80% capacity', or 
800MB. 



Table 11-1 Watermarks for a 1000 MB Filesystem 



Watermark % Capacity # of MB 



HWM 


95% 


950 MB 


LWM 


88% 


880 MB 


PSWM 


80% 


800 MB 



Disk Utilization Zones The watermarks divide the filesystem into disk utilization zones 

(see Figure 11-8). Tlie space between 100% capacity' and the 
HWM is the yellow zone, the space bet\\'een the HWM and the 
LWM is the green zone, the space betw^een the LWM and the 
PSWM is tlie prestage reserve, and the space between the L'^'-TVl 
and the non-stageable data is the working set. 
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Figure 11-8 

100% Capacity 
HWM 

LWM 



Utilization Zones 




= largest regularly stageable file 



>- total size of all files created or 
staged-in per day 



3l size of all Mies accessed in k 



>- space for inodes 

+ space for locked down files 

+ space for directories and symbolic links 



The yellow zone is resei'ved for processes to use wliile migration 
brings filesystem usage back down to the LWM. It represents 
tiie area between 100% capacity and the HWM. Note that if you 
make your yellow zone slightly larger than the largest regularly 
stageable file in your filesystem, the system can use tliis space 
to stage in or create most any file immediately, while migi-ation 
then frees additional space by staging out other files, usually 
from the prestage reserve. 

The green zone represents the area ben^-een the HWM and the 
LWM, and is the normal zone of operation. Tlie green zone 
should be large enough to hold tlie average number of new 
disk blocks added in a day, including both new files and previ- 
ously inactive (staged-out) files that are likely to be accessed 
(staged-in). It should be large enough to make event-driven 
staging infrequent. Making the green zone larger or smaller is 
the most common change to the default configuration. 
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The prestage reserve is used for files that liave been staged out, 
but also remain on the system's magnetic space. Tliis magnetic 
space can be released quickly if disk utilization crosses the 
HWj\1. To allow filesystem usage to return to the LWM during a 
demand-staging event, the prestage reserve is typically the same 
size, or slightly larger, than the green zone. 

The ivorking set represents the files that are accessed in a given 
period of time. For general applications the working set should 
be in the 7-30 day range. The magnetic disk space holding the 
working set is actually a combination of the prestaged resen-'e 
space (since these files, altliough staged, are still magnetic 
resident) and the amount of space available to siageable files 
below the PSWM. lliis area needs to be large enough to contain 
all files accessed in tlie last n days, where n is tlie number of 
days wordi of recently accessed files tliat you want to fit within 
the working set. 

Non-stageable files and other disk structures also consume 
space; these include space for all directories and symbolic links 
or for any otlier files that cannot be staged (for example, swap 
files). 



Sample Watermarks Consider using one of the sets of watermarks listed in 

Table 11-2 for your configuration. 

Archive settings are designed for filesystems whose files are 
written once and rarely, if ever, read. Tlie filesystem 's data is 
typically staged-out and rarely, if ever, staged back in. Tliis is 
the case if large amounts of data are gathered every day and 
quickly "archived" off of the magnetic disk. 

The Cached settings are designed for filesystems in which reads 
outnumber writes, and a relatively predictable set of files are 
read, lliis setting takes advantage of migration's abilitv' to keep 
the most recently-accessed files on magnetic disk, thus ensuring 
optima] performance. 
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The Random settings are also intended for situations where 
reads outnumber writes, but where the access pattern is random 
and least-recently-used caching is ineffective, lliis would be the 
case, for example, in a government records office, where 
several files must be read in from staging media in order to 
analyze a new file. When the analysis is completed, there is no 
need to keep the files on magnetic disk, because tlie files are 
not accessed again for an undetermined period of time. You can 
select tills setting for filesystems tliat match tliis landom data 
access pattern. 

You can use tliese settings as a guide for configuring your 
filesystems. 

Table 1 1-2 shows the sample watermark settings. 



Sample Watermark Settings 



Watermark 


HWM 


LWM 


PSWM 


Cached 


95% 


880/0 


80% 


Aixhive 


66% 


33% 


0% 


Random 


(mi 


34% 


17% 



The watermarks for Cached filesystems are calculated to 
maximize the magnetic cache and minimize stale space on 
staging media. 

For archive filesystems, the sample watermarks divide magnetic 
disk space into tliree equal zones by setting the high, low, and 
p re-stage watermarks at 66%, 33%, and 0%, respectively. Any 
stageable file that is moved onto the disk is prestaged during 
the next periodic or demand staging run. 
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Figure 11-9 



Usage level exceeds PSWM. 



PSWM Set at 0% 



33% Staging Media LWM 



Magnetic 



Migration prestages files 
to staging media. 



No change in usage level. 



If an archive filesystem contains some temporary files that 
remains on magnetic disk, you should increase the prestage 
watermark to take tliis into account. For example, if a 300 MB 
archive filesystem is expected to have 20 MB of temporaiy files, 
you can set the PSWM at 20% and divide tlie remaining 80% 
into equal zones of 26.6%. Thus, the ISiHsi is set at about 47% 
and the UWM at 74%. 



Watermarks for Archive Fllesystems 



Watermark 


HSM 


LWM 


PSWM 


Default 


66% 


33 


0% 


With 20% Temp Files 


74% 


47% 


20% 



For fllesystems where the random access pattern predominates, 
the aming is somewhat similar, llie major difference is that 
when the magnetic disk gets full, it is filled with prestaged files 
that have been just staged in, whereas archive fllesystems are 
filled with new files. Tlie PSWM is set at 17%. If you expect to 
fill more than 17% of tlie filesystem witli temporaiy files, raise 
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tlie PSWM and create equal-sized yellow and green zones and a 
preslage zone of about half the size of tlie gi-een zone. For 
example, if a TOO MB Random filesystem is expected to have 25 
MB of temporary- files, you can set the PSWM at 25%, the LWM 
at 40%, and the liWM at 70%. 



Table 11-4 Watermarks for Random Filesystems 



Watermark 


HWM 


LWM 


PSWM 


Default 


6m, 


34% 


17% 


With 25% Temp Files 


70% 


400/0 


23% 



Configuration ISSUSS some issues that you need to consider when setting up HSiM are 

the number of files in a filesystem, the type of media you plan 
to use, and whether or not to enable self-describing media. 



Filesystem Limits Although EMC's HSM products provide virtually unlimited disk 

space, all filesystems, even stageable ones, are limited by the 
number of files, directories, symbolic links, and devices tliey 
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can contain. For the reasons listed in Table 11-5, EMC recom- 
mends that you restrict filesystems to no more than one million 
files. 



Reasons to Set Filesystem Limits 



Explanation 



lo ensure a filesystem backup 
within a single session 



To ensure efficient candidate lis' 



To ensure efficient use of 
magnetic disk space 



Because filesystems provide natural boundaries for backups, having 
less than one million files on a filesystem allows the entire filesystem to 
be backed up in one nin with no more than 4 work items. 

Migration selects candidates to stage out by searching all the files (free 
and used). Although this searching is normally done during off-hours, it 
also occurs during demand staging nms. lire more files in the 
filesystem, the longer it takes to create the candidate list. 

.Most Unix-based systems maintain an inode (also refened to as a file 
serial number) for each file, directoiy, symbolic link, and device. Each 
inode consumes a certain number of bytes, depending on the particular 
operating system. 



If you expect a filesystem to consist mostly of many smaller 
files, or to contain many links, you may find that the filesystem 
is in danger of running out of inodes. To prevent this from 
happening, you can decrease the inode density, that is, the 
number of bytes per inode, at the time of filesystem creadon. 



Stage-fo-Tape Considerations hsm supports staging to EO, WORiVi and DLT. in terms of 

durability and performance, optical disks are the best choice. 
Althotigh tapes are the most cost-effective media, they are not 
recommended for applications that require frequent staging- in 
of data. 

In general, staging to tape is only applicable in the following 
situations: 

• In archival environments (where there are veiy infrequent 
stage-ins) 
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• For restaging infrequently-used data to a secondary staging 
device 

• For baseline backups (which use migration technology) 
The limitations of tape are: 

• Tapes are less durable than optical disks. Wliereas DLT 
tapes are good for tens of tliousands to hundreds of 
thousands of passes, optical disks have no pass count limit. 

• DLT tapes have an archive life of around 30 years, but 
optical disks have an archive life of 25 to 100 years, 
depending on the manufacturer. 

• Tapes are slower. Whereas stage-ins from optical libraiy 
units usually take less than 20 seconds, stage-ins from DLT 
tape can take several minutes on a relatively idle libraiy 
unit, and much longer on a system with high stage-in 
activity. 

Important variable settings for stage-to-tape are described in 
"Tuning for Staging to Tape" on page 13-3. 
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Refer to Table 11-6 for a description of the tradeoffs in using 
stage-to-tape. 



Table 11-6 Stage to Tape with Tape Libraiy Units 





Primary staging Primaiy staging Secondary 


Baseline 


Migrate backup 




device 


device 


staging device 


backup 


catalogs to 












tape"" 






2 or more 


1 or more 


1 or more 


1 or more 






drives 


drives 


drives 


drives 


EMC Policy 


Disqualified 


Conditional 


Conditional 


Su oited 
, uppoitcc 


Conditional 


Perfor- 


Only capable of 


Two drives 


Good, since 


Good 


Insignificant, 


mance 


seivicing -15 


capable of 


optical, not tape. 




since only 




stage-in requests 


sere icing ~30 






catalogs are 




per iioui'. 


stage-in requests 


user stage-in 




staged. 






per hour. Four 


requests. 










drives capable of 












servicing ~60 












stage -in requests 












per hour. 








Media Wear 


Significant 


Significant 


Not an issue if 


Insignificant. 


Insignificant, 




problem unless 


problem unless 


data moved to 


Should create 


since access rate 




used in real 


used in archive 


the TLU is 


low tape access 


is low. 




ajxhive applica- 


applications. 


accessed infre- 


schedule. 






tions. 


quently. 






Deadlock 


Significant 


Significant 


No deadlock 


No deadlock 


Reduced, since 


Potential 






cases 


cases 


staging of 



catalogs is low 
fiequency 



activity. Can be 
minimized by 
careful sched- 
uling of backup 
and l ISM appli- 
cations. 



1. To eliminate tlirasliing, at least two drives are required, one drwe to read in staged data and one drive to write 
backups to tape. 



EDM Software Reference 



11-22 



Basic HSM Concepts 



Self-Describing (Media With self-describing media enabled on the migration server, 

migration stores the full pathnames of migi^ated files on the 
staging media. This allows the media to be moved from a 
migration server to another server. With self-describing media 
enabled, however, migration will require more time to stage 
files. 

You can enable or disable self-describing media with the 
emstconf command. 



Periodic Staging and as part of your nightly maintenance, you should schedule 

Filesystem Delay periodic staging runs of your filesy stems to bring disk utilization 

down to the LWM. Periodic staging runs are set up through 

root's crontab file. 

If you're staging out files from more tlian one filesystem, you 
should stagger migration to minimize loads on your system. The 
actual time that staging liegins for each filesystem depends on 
the filesystem's delay parameter, which you can set with the 
emfsconf command. 'Hie filesystem delay parameter specifies 
the number of minutes to wait after tlie nightly staging run is 
scheduled to start before beginning stage-outs for a given 
filesystem. 

In setting the delay, you should also consider backup 
schedules. Generally, you should schedule backups to run after 
periodic stage-outs. 
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File Control Properties File control properties influence, and in some cases determine, 
the selection of files to stage out. You can list file control 
properties and file sizes with emls -1. You can change file 
control propeities with emchmod. Tine file control properties 
are listed in Table 11-7. 



Table 11-7 File Control Properties 



Property 




Description 


Locked 




Loci<s the file onto magnetic disk; never 
stage out the file. 


Convenier 


)t Stage Out 


Stages out the file at the next convenient 
time, probal^ly during tlie next periodic run. 


Keep 




Used in conjunaion witii convenient stage 
out to cause files to be prestaged rather than 
fuUy staged out. 


Residence 


Priority 


Prioritizes the importance of keeping the file 
on disk. All otlrer things being equal, files 
with lowest priority' are staged first. Piiorities 
are expressed as integers. The highest 
priority is 1; tire lowest pi-iorit\' is 63, 



Directories have two sets of properties: one set applies to the 
directoiy itself (Directories are not staged out, so setting a 
directory's own properties has no effect), and the otlier is the 
inheritable set. ^X'l^en files are created, their own properties are 
inherited from the parent directory's inheritable set. When 
subdirectories are created, both the parent directoiy's own set 
and its inheritable set are inlierited. Thus, file control properties 
are passed down through directory trees. 

The residence priorit)' remains set when a file is staged out and 
back in. Tlie coiwenient and keep properties do not 
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Although you should use all properties with care, be especially 
careful with the lock property. Choosing to lock some files on 
magnetic disk to increase the performance of one application 
could result in system-wide performance degradation. Locking 
too many files can prevent migration from working at all. 
Before locking files onto magnetic disk, try small changes to the 
residence priority. Monitor the system carefully to detemiine the 
effect both on the application and on die system as a whole. Be 
careful about setting the inheritable lock property on a 
directory. All files and directories that are created below that 
point inherit the lock property. 



Listing and Changing File 
Control Properties 



You can list file control properties and file sizes with emls -1 
(see Table 11-8 for flag names), llie following example lists file 
control properties and file sizes for all of the files in the archive 
directory: 

ediTi-o emls -1 archive 



1024 0 0 1 60 

24 898 0 0 

1 0 --CK 60 0 

In this example: 

• The file "filexyz" uses 1024 KBs of magnetic disk space and 
is locked on the magnetic disk. 

• The file "fileabc'" was staged out to volume #002-a on 
staging trail Archive, where it uses 898 KBs of disk space. 
A fencepost of 24 KB remains on magnetic disk. (A 
fencepost is the portion of a staged-out file tliat remains on 
magnetic disk.J 

• Any files created in the "dirabc" directory are prestaged at 
migration's earliest convenience. 
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Directories have a set of inlieritable properties, which are 
displayed in uppercase letters in tlie I-Jlags column. Both 
regular files and directories have a set of staging control 
properties that apply to the file or the directory; these properties 
appear in lowercase letters in die Flags column. 



Table 11-8 File Control Property 



Property 


l-Flags 


Flags 


Locked 


L 


1 


Convenient Stage-out 


C 


c 


Keep 


K 


k 



The I-flags column also displays the residence priority' integer, 
which is a value of 1-31 (set by root) and 32-63 (set by 
ordinary users). 

I'he Flags column displays the file or directoiy's own properties 
as the corresponding lowercase letters and priority integer. A 
minus sign (-) indicates that the property is not set. 

You can change file control properties with emchmod. Tlie 
emchmod command sets die file or directory's staging control 
properties. In order to change properties you must be either die 
superuser or the owner of the file. Unlike chmod, emchmod 

clears properties if they are not specified on the command line. 

The following example shows how properties are inlierited: 

1 . Assign convenient property and residence priority. 
edm# mkdir archive 

edin# anohmod -C -P36 archive 

2. Display properties, 
edint emls -1 archive 

Mag KB Stg KB I-flags Flags Staging media Volume Barcodes Filename 

1 0 — C- 36 0 - archive 



EDM Software Reference 



11-26 



Basic HSM Concepts 



3. Create subdu-ectories. 
edm# cd archive 
edm# lokdir arcl 
edin# mkdir arc2 

4. Display properties. 
edm# emls -1 * 

Mag KB Stg KB I-flags Flags Staging media Volume Barcodes Filen. 
1 0 — C- 36 0 - ar. 



5- Create files. 
edm# cd arcl 
edra# touch filel 
edm# touch file2 

6. Display properties. 
edm# emls -1 * 

Mag KB Stg KB I-flags Flags Staging media Volume Barcodes Filename 

0 0 0 --C- 36 - filel 

0 0 0 — c- 36 - file2 

emchmod has several optional switches that allow you to 
expand the HSM file control properties. By default, symbolic 
links are not followed by einchmod. If you use the -s option, 
the change applies to all the symbolically linked files. 

If you know when you create a directory what properties all the 
associated files should have, specify tlie inheritable properties at 
that time. If you decide after you have created a direcfoiy what 
properties it should have, use the -r option, to recursively apply 
the properties. 

Normally, emchmod silently sets and or changes properties. If 
you use the -v option, emchmod prints a message to your 
screen as it changes every file. 
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Over time, some files that were staged out are deleted. Other 
files are staged back in, and some of them are modified. 'Hie 
old staged image of a deleted or modified file is considered 

stale. 

Gradually, the number of stale files on staging volumes grows, 
and the volumes become candidates for compaction. When you 
compact staging volumes, you actually stage in the files tliat are 
not stale to magnetic disk and then, if they were not accessed 
recently, you stage them out again to new staging volumes. 

Compaction is in effect a garbage collection process that creates 
space for new files by reducing the number of active staging 
volumes. It frees space in a Ixill libraiy unit for new staging 
volumes and/or ensures a pool of available media. 

In most cases, staging media is compacted automatically via an 
emcompact entry in root's crontab file. With automatic 
compaction, emcompact automatically determines which 
volumes to compact. 

You can also compact staging volumes manually, if you want to 
compact any additional volumes. Both automatic compaction 
and manual compaction use the emcompact command. 

If you need to compact some staging volumes manually: 

1. Use dbreport s compaction report to decide which 
volumes to compact. 

# dbreport compaction 

The compaction report is divided into thi-ee sections, llie 
most likely volumes to compact are tliose listed in tlie last 
few lines of the first section. Tliese are the volumes wixh die 
highest percentage of stale files. 

2. Use emcompact to compact flie volumes. In tlie case of 
EOs, which have two sides, you need to specify each side, 
or volume, separately. You can specify volumes by: 

- volume ID 
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- sequence number (for single-sided media) 

- sequence number and side (for double-sided media) 

- barcode (for single-sided media) 

The following example compacts both sides of disk #10: 
# emcompact EO 10-1 10-2 

You can type the command without any arguments to find 
out the legal media types. (In the case of tapes, you can 
specify a barcode.) 

You can ovenide EDM Migration's file residence policy by 
running emcompact with the — p (policy) option. The -p 
option ensures that all files from the compaction source 
volume are staged out to the compaction output volume 
and none remain on magnetic disks. 



Administering Compaction You can perform several tasks on a regular basis to ensure that 

compaction is working smoothly. 

CAUTION: In order to ensure a complete file recovery 
process, you should disable automatic 
compaction and emvck as soon as you 
realixe that you've lost a filesystem or a 
significant portion of one. 

• Check the Volume Request window every morning to see if 
automatic compaction has lilocked. 

• Keep a supply of blank, easily accessible and unlabeled 
volumes, which you can label and allocate as compaction 
output volumes. 

To increase the likelihood of maintaining a supply of free 
volumes, you can also convert unrestricted staging trails to 
restricted ones, or prelabel volumes for a specific trail. 

• Check the message files eveiy day. 
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If automatic compaction frequently fails to reach the free 
goal, the system might have reached the limit of its data 
storage, given the number of volumes in the libraiy unit or 
the time available for compaction. 

In such a case, use the dbreport appl_usage report to 
determine whether enough stale space is available to 
reclaim, or whether you should add more volumes to your 
library unit. For example, in an EO system with volumes 
that average 25% stale data, you have to compact four 
volumes in order to get a single free volume (refer to 
Figure 11-10). If tWs rate is unacceptable in your 
environment, add more blank volumes. 



Figure 11-10 



Freeing Volumes for Use 

Compaction Source Volumes Compaction Output Volumes 



75% Active, 25% Stale 




100% Active (full) 



□ 



S = Stale Data 

□ = Active Data 

□ = Free 



Available Volume 



Compacting Baseline Compacting baseline volumes is similar to compacting staging 

Media volumes, except you can only compact baseline volumes 

manually. Compacting baseline volumes causes all currently 
active data associated witli the volume to be copied to the 
cuiTent compaction volume associated witli tlie baseline trail. 
New baseline compaction volumes are allocated as necessary. 
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As a general goal, you should limit the number of active 
baseline volumes to the number of active staging volumes. If 
possible, you should also limit the nuniter of active baseline 
volumes to tlie number of slots in your library units. This facili- 
tates recoveiy in the event of a site disaster by ensuring thai all 
of the baseline media (to wliich active files are attached) fit in 
your library units. 

To compact baseline volumes: 

1 . Run dbrejx)rt baseline vi/eekly and refer to llie "pct_stal" 
column for baseline volumes. 

# dbreport baseline 

2. Use emcompact to compact tlie N most stale optical disks 
or tapes. (In the case of optical disks, there are two 
volumes per disk.) The value of /^ varies, but it is at least 
the number of active baseline media minus the nmnber of 
active staging media or slots in your libraiy units, whichever 
is less. 

Therefore, if you have 55 active baseline media, 45 active 
staging media, and a 50-slot libraiy unit, compact at 
minimum the ten most stale baseline media. 
This results in a set of compacted baseline volumes. Note 
that these volumes are not deallocated and available for use 
until all existing baseline-relative backups that reference 
them expire. 



^igrBtiOn RSpOrtS EDM HSM option and EDM Migration contain several reporting 

tools tliat you can use tcj monitor system performance. 

The dbreport compaction command generates three reports 
that you can use to determine which staging volumes to 
compact with tlie emcompact command. 
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The emfs report program provides virtual filesystem statistics 
for the server and for netw^ork clients. It displays the amount of 
stageable and unstageable filesystem data, and the amount of 
data cun-ently staged. Most importantly, it shows you the 
number of days worth of data being cached on magnetic disk. 
See "enifsreport and the Working Set" below for furtlier details. 

The emsstat program displays activity levels for the network 
migration server. It gets its infomiation by accessing statistics 
that are kept in a shared memoiy segment that all active EDM 
Migration server daemon (emsd) processes use, or from a 
statistics file if emsd is not mnning. 

The emcheck progi-am checks the cun-ent migration configu- 
ration on the server or on a network client. 

Refer to the appropriate man page for further details. 



emfsreport and the Working 
Set 



Note that in the case of an archival environment where you 
expect to have no working set on your local disk, all accesses 
result in stage-in faults. 

If your working set of files is considerably larger than your 
actual magnetic disk space, you experience system performance 
degradation. If you access large amounts of data within a short 
period, migration must stage files in and out continuously. This 
constant staging of files is called thrashing and should be 
avoided. 



In a virtual filesystem, the files that you use most often, your 
imrking set, should fit on the magnetic portion of the filesystem, 
thus guaranteeing that most file accesses do not require staging 
volumes to be mounted. Your working set is often measured as 
the number of days worth of files that are stored on the 
magnetic disk. Tliis is called the working-set-in-days. Tiie ideal 
working-set-in-days varies from site to site and from filesystem 
to filesystem, but EMC recommends you tiy to maintain several 
days worth of data on your local magnetic disks. 
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To find out your working set size and working-set-in-days, use 
emfsreport. Tlie enafsreport program provides you with 
filesystem reports that enable you to monitor usage and thus 
fine tune your system. The emfsreport program can provide 
you with information such as: 

• the number of files in a virtual filesystem 

• the amount of stageable data in a virtual filesystem 

• a filesystem's usage pattern for a particular day, for 
example, the total amount of space used by files created or 
modified in a day (that is, what is required for the green 
zone) 

• the size of your working set 

When you run emfsreport witli the -hva option, you see a 
report of the virtual space by age since the last file access or 
modification. It also reports the size of the filesystem's working 
set. The working set size is the amount of stageable magnetic 
information tliat the filesystem can have without exceeding the 
LWM. llie days worth value, which is based on observed access 
patterns, is the number of days it takes EDM Migration to cycle 
through an amount of data equal to the working set size. 

Remember that this report is a snapshot of a specific moment in 
time. If you were suddenly to request many more files than 
nomial, or if you were to create a large amount of new data, the 
working set period would be less than this estimate. 

If you find that your working set is much larger than your 
physical space, that is, you have too few days worth of space, 
delete files or move them to another filesystem. Also, check that 
your system activity is evenly balanced across your disks. If 
your working set is still too large, add more magnetic disks or 
modify your application. 
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Baseline Backup Baseline backup provides a higlily efficient means of backing 

up large amounts of data. With baseline backups, you back up 
all of your most stable files, which, at minimum, consist of all 
the files that are staged out to the staging media. From that 
point on, you pejform backups relative to the baseline; that is, 
the baseline backups take care of the data that is staged out, 
while the regular backups take care of everytliing else. 

Baseline backup actually uses HSM softwai-e, rather tlian 
backup, to move data. In essence, it causes data to be staged 
out twice, and thus provides you with additional protection 
against the loss of your data. If, for example, you lose your 
primary staging media, due to fire or accident, you can still 
locate your files on the secondaiy staging media (that is, the 
baseline backups). 



ReStagimS Data HSM supports multi-level staging with its restage command, 

w^hich incorporates enhanced find syntax. Using restage you 
can qualifv' files to stiige and then migrate, or re-migrate files to 
a specified staging trail, force migration of a set of files, or 
establish an arbitrarily layered, staging hierarchy. 

Multi-level staging is particulaiiy usefiil when you want to free 
up space on your staging media. You can configure staging to 
automatically migrate data from magnetic disk to a staging trail, 
and then restage to another trail. If you want, you can move 
the restaged data to offline storage. See tlie restage man pages 
for more information. 
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Backup Completeness Backup work items for filesystems tliat are under migration 

control have a completeness setting that prevents duplicate 
backups of the file data. The completeness setting limits tlie 
files for which the data portion is written to the backup. (The 
extended inode is included for each file scanned, regardless of 
whetlier its data is written out) 

You should leave the completeness settings at tlieir defaults, 
listed in Table 11-9. The initial setting varies depending on the 
type of file being backed up (as noted in tlie table). 

If you really need to change a completeness setting, you must 
edit eb.cfg directly: no setting is available from the graphical 
user interface. Editing eb.cfg directly is always a dangerous 
tiling to do, so you should make a copy of your eb.cfg before 
editing. 



Table 11-9 Completeness Settings 



Setting 


Description 


Applicable For 


Default For 


All files 


Back up the data portion of all 
files in the filespec, regai'dless of 
wliere they're stored and whether 
they're baselined. 


All clients (this is the 
only option available for 
backup clients that are 
not also EDM Migration 
clients) 


Non-migration 
clients and 
backup's database 
files on the seiver 


Resident files 
only ^ 


Back up the data poition ior only 
those files that are resident (local 
to) tlie client; or, for the sender, 
that are stored on the magnetic 
disk. 


EDM Migration clients 

Levels 0-9 on the 
backup seiver (i.e., the 
local client) 
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Table 11-9 Completeness Settings (Continued) 



Setting 


Description 




Applicable For 


Default For 


Files not 


If a file has been stage 


d, only 


EDM Migration clients 


EDM Migration 


backed up in 


back up the data poitii 


3n of the 






irugration store 


file if its staged versior 


1 liasn't 








been backed up yet or 


1 the EDM 








Migration servej-. 








Non-baselined 


Back up the data portion for only 


Local (server) client (but 


Local client 


files oriy 


those files that aren't baselined 


not backup's database 


(except backup's 




(for use after a baseline 


2 is taken). 


files) 


dataliase files) 




This option is only ava 


.ilable if 








you have Baseline Backup. 







1. EMC recommends lhai you use Files not backed up In migration store wlih EDM Migration networic 
clients, and Non-baselined files only for the local migration server. Tlie Resident files only setting can 
leave you wlnerable unless there is a backup of the client store. If you don'i back up a file that has been 
staged out, but you lose the file's clienl store on the serx'er before the seiver's files are ijacked up, llie only 
way you will be able to recover the file is from an old backup. 
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How Migration 
Works 



lliis chapter describes the roles of the HSM daemons, 
processes, and database files in migration services on the server 
and clients. 

The following topics are discussed in this chapter: 

• What Happens When You Enable Migration 

• How Stage-Out Works 

• How Stage-In Works 

• How the User-Level Commands Work 

• How the Network Migration Server Works 
" How Compaction Works 
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What Happens When You When you enable filesystem migration, you set up migration 
Enable Migration parameters, such as watermarks and a delay factor, and you 

specify the type of media to wliich files migrate. 

When you enable filesystem migration, HSM does tlie following: 

• It stores configuration information in tlie liSM configuration 
database. 

• It creates a holding place for the migration candidate list 
(See "Candidate List Generation" on page 12-5). 



Migration Configuration The hsm serv^er and every IISM client contains a migration 

Database configuration database. 'Fliis database consists of structured text 

files that are updated by the emstconf, emfsconf, and 
emsysconf commands and by the functions you perform when 
using the HSjM Configuration Interface. 

CAUTION: Although these files are text files, you 

should never attempt to modify them with 
an ordinary editor. The configuration 
conamands and the HSM Configuration 
interface do more than just modify the files; 
they also know how to interact correctly 
with any staging processes that are 
rumiing. 

The database contains information that specifies which 
filesystems are stageable, when files should be staged, and 
which staging templates filesystems are assigned to. 

On client systems, die database also lists the fileserver and store 
that staging templates are assigned to. 

I'he database files are stored in the /usr/epocli/etc/mal/ 
directory. 
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What Happens When You Enable Migration 



Figure 12-1 



Configuration Datebase 




Migration Database Files 



Argument 



em_stage_db 



Description 



Text file containing system-wide configuration 
data. You update this file with the emsysconf 
conmand or when you change global properties 
with the HSM Configuration interface. 



"i'ext file containing staging template configuration 
data. You update this file with the emstconf 
command or when you change staging template 
information with the HSM Configuration interface, 

em_store_db Text file containing client store information. You 

update this file with the emstconf command or 
when you change store information with the HSM 
Configuration interface. 

em_fi]esys„db Text file containing per-filesystem configuration 
ciata. You update this file when you issue the 
emfsconf cominand or when you change 
filesystem information with the HSM Configu- 
ration interface. 

em„baseline_db Text file containing baseline backup information. 



EDM Software Reference 



12-4 



How Migration Works 



HSM stages out files during nightly staging runs (periodic 
staging), when disk space usage crosses the high watermark 
(demand staging), or when the emstage command is issued. 
(See "When Files Stage In and Out" on page 11-2 for furtlier 
details.) 

There is a limitation of a maximum of 2GB minus 1KB for tlie 
size of files to be staged out or staged in. 

Both periodic and demand stage-outs occur via the interaction 
of the following daemons and processes: 

• The EDM Migration file monitor daemon (emfmd) 

• The emmasterd daemon 

• The em_make_cl process 

Both the emfmd and the emmasterd daemon are started at 
boot time. The emftnd detects liigh watermark faults and then 
communicates with tlie emmasterd daemon, which starts a 
worker daemon. Tlie worker daemon starts up em_make_cl, 
which fills in the candidate list and thus, determines which files 
to stage out. 

These daemons and processes are described more fully on the 
following pages. See "How the User-Level Commands Work" on 
page 12-7 for information about emst^e. 



The File Monitor Daemon The emfmd detects events that require migration inleivention 

(emfmd) and then communicates with the emmasterd daemon. The 

emimasterd starts a worker daemon whidi acaially stages out 
the file(s). (Previous versions of HSM provided the functions of 
the emfmd via the Unix kernel.) 

The emfmd detects tlie following types of events: 
• Filesystem space utilization at (or above) the high 
watermark 



How Stage-Out Works 
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• Read or write accesses to prestaged or staged files 

• Deletions of prestaged or staged files 

• Filesystem mount and unmount operations 

When a user program requests a file that is not staged out, the 
emfmd determines that no staging actions are necessary and 
nornial system processing proceeds. The emmasterd daemon 
only gets involved when it is necessary to stage out a file. 



The Master Staging Daemon when an HSM seiver or a migration client boots, it starts the 
(emmasterd) master staging daemon, emmasterd, from /etc/rc3.d/S21mal. 

This daemon is responsible for staging out files from the clients 
to tlie server and from the server to the staging media. The 
emmasterd daemon keeps disk space utilization below the 
high watermark by staging out files and releasing their magnetic 
blocks. 

Thereafter, the master starts, monitors, and restarts one worker 
daemon per filesystem, both periodically and on demand, when 
the emfmd notifies it that filesystem utilization exceeds the 
high watermark. The workers are also named emmasterd. 

Only one real emmasterd process can ever run — tlie worker 
processes are simply forked copies, lliey appear as 
emmasterd processes when you run the ps command. 

The simplest way to tell the difference between a worker 
process and the real emmasterd pj-ocess is to look at the 
/usr/epoch/etc/mal/emmasterd.pid file. When emmasterd first 
begins execution, it writes its process ID into this file. 



Candidate List Generation when migration needs to stage files, an emmasterd worker 

process spawns em_make_cl, wliich creates a prioritized list of 
stageable files. 
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In selecting files to stage out, em_make_cl evaluates the time 
since the last file access, the size of the file, and the file's 
residence priority attribute (see the man page for enichmod - 
P). 

Files with lower residence priority' are usually staged first. (Tlie 
lowest priority is 63; the highest priority is 1.) Tlius, files widi 
priorities from 33 to 63 are more likely to be staged out, and 
files with priorities from 0 to 31 are less likely to be staged out. 

Only tlie superuser can raise priorities (by setting priorities in 
the range 1-31). All users can lower priorities. 



What Happens When a File is The first time a file is staged out, migration writes the file's 
Staged Out entire magnetic image to die next level in the staging hierarchy, 

that is, to the client store or die staging media. It keeps a small 
portion of the file on magnetic disk and releases tlie rest of die 
magnetic space. The portion of a staged-out file diat remains on 
magnetic disk is called the fencepost. 

This fencepost is useful, because many commands, such as file 
and head, only need to read this small portion of the file. 
Consequendy, when these commands are mn, HSM doesn't 
need to stage in die entire file. When a file is staged out a 
second time, it releases the magnetic space occLipied by the 
fencepost. 

FUes that are staged in reside on both magnetic disk and the 
staging media (or client store). If the file is staged out again 
widiout being modified, migration uses the same staged image 
and releases the magnetic space. If the file is modified and then 
staged out, migration writes a new image on the staging media 
or client store. 
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How Stage-In Works stage-ins occur due to the interaction of the HSM file monitor 

daemon (emftnd) and die stage-in daemon (emsld). The 
emfmd detects a request for a staged out file (or a request to 
delete a staged out file) and notifies the emsid, wliich stages in 
some portion of the file, or, in the case of delete operations, 
deletes the file's staged image. 

Scripts that run at system boot time automatically start up 
several stage-in daemons. Each stage-in daemon can handle 
one stage-in request at a time, which allows for multiple, simul- 
taneous stage-in requests. 

A staged-out file is logically divided into small chunks, called 
buckets. A file can be divided into anywhere from one up to a 
maximum of 64 buckets, 'flic size of tlie buckets is based on the 
file's size. As tlie size of the file increases, tlie size of the bucket 
also increases. 

When certain applications and processes request to read a 
portion of a staged-out file, migration stages in only tliose 
buckets that contain the requested data. Whenever a file is 
modified in any way, migration stages in the entire file and 
makes the previous staged image invalid or stale. 



How the User-Leve! The user-level commands (emchmod, emls, emstage, and 

ComiTISndS Work embsl) enable users to set and list file attributes for stageable 

filesystems and to specifically request the staging of particular 
files. The user-level commands interact with the migration RPC 
daemon (emrpcd), w^hich, in turn, interacts with the enafind. 

For more information al30Ut the commands, see the man page 
for each individual command. 
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How the Network Nefft'ork migration server sofm^are mns on the EDM server and 

Migration Server Works consists of the foiiox\ 'ing components as listed in Table 12-2. 



Table 12-2 Components of the Network Migration Server 



Component 


Description 




EDM Migration protocol 


and clients 


between seiver 


EDM Migration daemons 


13aemons tiiai servic 


e client requests 


Netw^ork migration 
seiver database 


Files that track netw 
activity and the defa 


ork migration 
ult client store 


Client stores 


Directories that hold client bitfiles 



The EDM Migration Protocol Network migration server software uses the EDM Migration 

protocol to enable communication between the clients and the 
server, llie EDM Migration protocol is a remote procedure call 
(RFC) protocol that consists of pairs of request and reply 
messages diat are passed between the client and sender. 
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Figure 12-2 



EDM Migration Protocol 



EDM 

(HSM Network Client Server) 



11 









Request 




TCP/IP 



The EDM Migration protocol is based on a connection-oriented 
u-ansport protocol (TCP/IP), requiring each client to establish 
one or more virtual circuit connections to the server. Tliis 
protocol reduces the effects of ti-ansport latency (round ti-ip 
time) on perfomiance and permits network migration to 
function well over both local and wide area netw^-orks. 



Network Migration Server 
Daemons 

The emsd is responsible for die following activities: 

• initializing the global statistics shared memoiy segment 

• parsing tlie global configuration file and store database 

• parsing the store cotifiguration files for each client store 

• registering Network RPC service information 

• listening for client system connection requests 

The emsd daemon is started at boot time. Wlien client 
connection requests arrive, emsd spawns subprocesses called 
client agents to handle them. Tlie emsd creates a client agent 
process for each connection. 



Network migration server activities are carried out by a 
hierarchy of daemons (all named tlie EDM Migration Server 
Daemon, emsd) and controlled by a set of administi-ative 
commands. (See the appropriate man pages.) 
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The client agent handles all requests over that connection for 
the lifetime of die connection. 



Figure 12-3 



Server Daemons 
Clients 



EDM Migration Server 



□ 



-u 




-u 






Client Agent 



Client Agent 



Client Agent 



Client Agent 



When an agent receives a request to access bitfiles in a 
particular store, the agent looks up the store configuration and 
state information in data structures inherited from the emsd 
process. A client agent can access any store to which its client 

system has access permission. 



Network Migration Server The netw'ork migration server has a global configuration 

Database database that contains information about network migration 

activity and the default client store values, 'llie global configu- 
ration database files reside in /usr/epoch/etc/mal . 
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Although both the emsd_conf_db and the emsd_store_db files 
contain editable text descriptions of the configuration, do not 
edit these files directly. Instead use the sender's configuration 
commands or the Configuration Interface to make any modifica- 
tions to the database. 

CAUTION: Editing these files directly may result in loss 
of data. 



Figure 12-4 



Global Database Files 




There are five database files as described in Table 12-3. 



Global Database Files 



Description 



Text file that defines ilie limits on the EDM 
Migration protocol requests and the default values 
for client sroi-e configurations. 

Binar)' file that contains information about the 
currently executing emsd pi-ocess. 



Text file that c 
stores and their locati 



list of configured client 
s on the sen'er. 



Binaiy file that contains cumulative statistics on 
EDM Migration protocol traffic and client agent 



Binary file that 
histoiy on tiie server 



the EDM Migration usage 
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Client Stores Each client store has its own file hierarchy and is logically 

independent from every other client store. Tlie client store's 
top-level directory contains three files and two subdirectories. 

As system administrator you see these files and directories when 
you list tlie contents of the client store directory. 



Figure 12-5 Client Store Organization 




The client store's top-level files and directories are listed in 
Table 12-4. 



Table 1 2-4 Client Store Files and Directories 



File/Directory 


Description 


store_cont_db 


'Jext file of the store's configuration information. 


store_state_db 


Text file of the store's stale information that the 
client agent keeps cun-ent. 


recoverjist 


List of the bitfiles to restore from the server's 
backups. 


new_bitfiles 


Temporary holding directoiy for bitfiles that are 
being created as part of a stage out from a client 
system. 


bitfiles 


Directory that contEiins tire completed bitfiles in a 
3-level hierarchy. 
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When the client agent creates a bitfile, it gives it a l6-digit 
hexadecimal name and places it in the new_bitfiles directoiy. 
The bitfile remains there until it is completely written. Once the 
bitfile is complete, the client agent moves it to the bitfiles 
directory. 



Bitfiles are stored at die bottom layei- of a directoiy hierarchy as 
shown in Figure 12-6. Bitfile names are l6-digit hexadecimal 
numbers representing the lowei- 64-bits of a file's bitfile ID. (The 
bitfile ID consists of the bitfile name plus the store ID.) 
Migration uses tliis organization so that a bitfile can be located 
by using the hexadecimal encoding of the bitfile ID. 
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Figure 12-6 Bitfile Hierarchy 




C[^2 5F8 1 78 AOO0 1 0 1 • • • C^^f^l^^^QO^O^^ 

Maximum of 2563 = 16M bitfiles 



How Compaction Works Compaction is in effect a garbage collection process that creates 
space for new files by reducing the number of active staging 
volumes. On systems with erasable staging media, compaction 
occurs automatically via an emcompact -c entry in root's 
crontab file. 



CompSCtlon GOSiS The object of automatic compaction is to reclaim storage space 

on the staging media by making sure that each staging trail has 
at least a certain number of available volumes to stage to. By 
always maintaining a sufficient pool of volumes, minimal 
operator intervention is needed. 

The emcompact command operates, however, under a pair of 
competing goals.- 
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• To compact as many volumes as possible without blocking 
itself. (A block occurs when EDM Migration needs to 
allocate a new volume in order to compact a volume, but 
there are no new volumes available.) 'llie emcompact 
program will block while waiting for a new volume, and a 
new volume request will be posted to the Volume Request 
window. 

• To begin compaction with the trail that needs it the most, 
that is, the trail with the fewest number of available 
volumes. 

The emcompact program only considers the volumes in the 
library units to determine the numl^er of volumes available for 
allocation to each staging trail. If tliat number is less than the 
value specified in the -a (automatic) option, it examines all the 
volumes and compacts enough to provide an adequate number 
of free volumes. By default, emcompact ensures there are at 
least tliree free volumes for each staging trail. After the source 
volumes are compacted, they are erased and made available for 
reuse. 



Example in the following CTontab entry, emcompact is set to run at 1:00 

a.m. eveiy morning: 

00 1 * * * PATH=/usr/epoch/bin:$PATH; export PATH; emcompact -c >/dev/null 2>&1 

This command specifies that autocompaction should be done 
according to the directives contained in the autocompaction 
configuration file /usr/epoch/etc/mal/emcompact.cfg, lliis fonn 
is typically called to compact reusable volumes in a library-' unit. 
See cron(lm) and the /usr/lib/crontab and 
/usr/epoch/etc/mal/emcompact.cfg files distributed with the 
system. 
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The Compaction Process when you run compaction automatically, emcompact first 

chooses a staging trail and then decides which volumes to 
compact within that ti-ail. For each staging trail, emcompact 
can allocate, as compaction output volumes, any volume tiiat is 
already allocated to tliat staging trail or any unrestricted volume 
from another staging trail, as long as both sides are available. 

Table 12-5 shows some sample staging trails and tlie volumes 
available for each trail at a certain point in time. Tliis infor- 
mation is used in the process that is described below. 



Table 12-5 Available Compaction Volumes 

Staging Trail Available Volumes 

Engineering 6 

Engineering_archive 4 

Documentation 2 

Documentation_archive 2 

CAD 1 

CAD-archive 0 



The process is as follows: 

1 . First, emcompact looks for trails that have less tlian n 
available volumes, {n is the number specified with the -a 
option, 3 in this example). Automatic compaction only 
operates on those trails that have less than n available 
volumes, so emcompact selects only the Documentation, 
Documentation_archive, CAD, and CAD_archive staging 
trails. 

2, Then, emcompact selects the trails that are least likely to 
cause a blocked process and require operator intervention. 
As such, it first looks for a trail with at least two available 
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volumes, in this case, Documentation and 
Documentation_archive. If there's more than one trail with 
at least two available volumes, but less tlian n available 
volumes, emcompact first chooses the trail witli tlie fewest 
available volumes. 

3. Then, emcompact selects the piece of media that is the 
most stale, taking into consideration both volumes, in the 
case of an optical disk. Tlie emcompact program also 
takes into consideration the disks' availability, so that any 
disks that are restricted to otlier trails cannot be considered. 

4. On that disk, emcompact selects the stalest side and 
compacts it. 

5. The emcompact program repeats Step 2 through Step 5 
until all the trails that started with at least 2 available 
volumes have had volumes freed up and now have at least 
n available volumes. 

6. The emcompact program repeats Steps 2 tlirough Step 5 
until all the trails tliat started with 1 available volume (CAD) 
have at least n available volumes. At diis point there is a 
greater potential for a blocked process. 

7. The emcompact program repeats Steps 2 through Step 5 
until all the trails that started witli 0 available volumes have 
at least n available volumes. At this point there is the 
greatest potential for a blocked process. 

At any time in this sequence, emcompact can run out of time, 
depending on the length of time specified in tlie -e switch. For 
example, if die command line specifies -e 120, emcompact 
will terminate in two hours. In this case, tlie program will exit. 
The next time compaction runs it starts the selection process 
over again. Most likely, it decides that the volume it was in the 
process of compacting is tlie best candidate to compact. 
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How Long Compaction Takes compaction takes a considerable amount of time; up to a few 
hours is not unusual, etncompact requires about five minutes 
to scan each filesystem and identify active files. The time 
required to stage die files in and out again depends on the 
number of blocks and can increase if compaction triggers event- 
driven staging. During compaction, all resident and stagednDut 
files (including the files staged out to the volumes being 
compacted), in all filesystems, can be used normally. If 
compaction is intermpted, you can restart it on the same 
volumes. 



Baseline Compaction compacting baseline volumes is similar to compacting staging 

volumes. Compacting baseline volumes causes all currently 

active data associated witli the volume to be copied to the 
current compaction volume associated with die baseline trail. 
New baseline compaction volumes are allocated as necessary. 

When that baseline volume is compacted it cannot be immedi- 
ately reused since there may still be baseline-relative backups 
referencing the volume. Wlien you compact a baseline volume 
you move the data of all active files that reference this volume 
to a different baseline volume. Tliis means that no new 
baseline-relative backups reference tills baseline volume. 

A compacted baseline or staging volume has no active data. 
You can verify this by checking the volume's Used Ik blocks field 
(for an optical volume) or Used files field (for DLT) with the EDM 
Library Unit Manager window. 



Deallocation and Reuse The deallocation and reuse of baseline volumes is handled by 

EDM Backup. When expiring backups, EDM Backup checks for 
active data on all baseline volumes by checking each volume's 
"KB used" field. If the field is zero, either due to the volume 
having been compacted or the volume having grown 
completely stale, EDM Backup considers this volume for deallo- 
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cation. After all of the baseline-relative backups that reference 
these baseline volumes expire, ebexpire can deallocate the 
baseline volume, making it available for reuse. 

Note tliat you can compact any baseline volume at any time. 
The deallocation of tlie volume is liandled by EDM Backup, 
which knows not to deallocate it if it is still required by any 
baseline-relative backup. 



Active Baseline Volumes a baseline volume is considered "active" if it has data on it that 

is needed by an unexpired baseline-relative backup. Such a 
baseline volume cannot be reused until it has been compacted 
and deallocated. 



Recovering from Site Disasters You should limit the number of active baseline media to the 

number of active staging media, and you should make sure tliat 
you can fit all of your active baseline media into your library 
unit at one time. 

The reason for tliis is that in the case of a site disaster you need 
to replace your damaged staging media witli your baseline 
media. (Note, however, that aldiough this should be a mainte- 
nance goal, tiiere is no real relationship between staging and 
baseline media.) 

Furdiermore, in the atse of a site disaster, tlie fewer baseline 
volumes you need to deal with, the better, lliat is, you do not 
want to have to purchase an extra library unit tecause you have 
more baseline media dian staging media. 

See "Compacting Baseline Media" on page 11-29 for information 
on how to compact baseline volumes. 
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^ O HSM Command- 
I ^ line Tasks 



Generally, HSM is configured from tlie graphical interface and 
requires veiy little day-to-day maintenance. This chapter 
describes tlie non-routine configuration and maintenance tasks 
that are perfomied mostly fi'om the command line. 

• HSM Commands 

• lest Staging 

• Set Up Periodic Staging 

• Tuning for Staging to Tape 

• Coordinating Automatic Procedures 

• Working with Individual Files 

• Checking the Staging Configuration 

• Copying and Moving Data 

• Monitoring Storage Space and File Sizes 

• Maintaining Non-Stageable Filesystems 

• Managing Your Magnetic Disks 

• Populating Filesystems 

• Disabling Filesystem Staging 

• Compacting Staging Media 
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• Compacting Baseline Media 

• Clearing Incomplete Bitfiles 

• Gathering Migration Store Statistics 

• Checking a Netft^ork Client's Staging Configuration 

• Troubleshooting HSM 

• Restoring a Lost or Damaged Staging Volume 

• Restoring a Lost or Damaged Staging Trail 

• Restoring a Lost or Damaged Filesystem 



HSM Commands A brief description of the administrative and configui-ation 

commands available for local and network ITSM systems can be 
found in "HSM Man Pages" on page 18-9. 



Test Staging Test that staging works by copying a large file, such as 

/etc/termcap, to a stageable filesystem, stage it out, and verify 

that staging took place. Refer to llie corresponding man pages 

for details concerning command arguments. 

emc# cd /homel 

emc# cp /etc/termoap 

emc# emstage termcap 

emcl emls 

Mag KB Stg KB Staging media Filename 

8 0 lost+found 

8 87 #0155-a doc termcap 



Set Up Periodic Staging Make sure an entry exists in root's crontab file for scheduling 
nightly, periodic staging mns. The follow-ing example is inserted 
into root's crontab file by the HSM installation procedure. 
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/dev/null 2>sl 



Tuning for Staging to Tape EDM witli HSM option comes configured for staging to optical 
media. If you are staging to tape, you can improve performance 
by causing larger stage-ins, and thereby less tape repositioning. 

You do lliis by using two parameters in the sen-'er's 
/'usi-/epoch/etc/msl/msl.cfg file and tlien enabling this modified 
configuration file. 

Optical media has a relatively quick seek time when compared 
to tiipe. Tlierefore, a small amount of data can be efficiently 
staged in from optical. This is how liSM is configured by 
default. 

For tape, however, reading small amounts of data for multiple 
users can cause thrashing against the tape drive. Larger stage-ins 
are required to cause less tape repositioning. Hie larger stage- 
ins are possible because magnetic media has a faster ti-ansfer 
rate than optical and a much greater storage density. 



Stage-tO-Tape Tuning The parameters are: 

Parameters 



• MSP_READ_AHIL4D_PERCENTAGE 

The percentage of die file to be read on each read-ahead 
during a stage-in. It must be a whole number. 

• MSP_READ_AHEAD_MAX 

A throttle on MSP_READ_AHEAD_PERCEN']AGE, it is the 
maximum number of bytes that are read on any give read- 
ahead, (lliis parameter is used to prevent the stage-in of a 
large file horn taking over the system.) 

The default settings for optical are: 
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MSP_READ_AHEAD__PERCENTAGE=25 
MSP_READ_AHEAD_MAX=1 0 4 8576 

If you are staging in from magnetic tape and have concurrent 
users you may want to change these to: 

MSP_READ_AHEAD_PERCENTAGE=34 
MS P_READ_AHEAD_MAX= 62914560 

For example, if a user tries to read in a 1 gigabyte file and the 
MSP„READ_AHEAD_PERCENTAGE is 34, then HSM tries to read 
in 300 megabytes. 

If you set MSP_READ_AHEAD_MAX=62914560, the stage-in is 
limited to 60 megabytes (or about 1 minute of time). 



Stage-to-Tape Tuning to edit these parameters and enable the modified configuration 

Procedure file: 

1. Edit the /usr/epoch/etc/'msl/msl.cfg file to edit or add the 
two parameter values. 

Note: You should make a copy of the original 

/usr/epcx:li/etc/'msl/nisl .cfg file. 

2. Kill an emfmd daemon (killing one child process should kill 
them all). 

3. Do an init 6 

or 

Restart the emfmd daemons witli: 

/usr/ epoch/lib/msl/emfmd 



Coordinating Automatic to ensui ■e maximum efficiency, you should coordinate all of the 
PrOCOdurBS automatic backup and staging procedures that are run through 

root's crontab file. Table 13-1 shows two sets of recommended 
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order of tasks: one for systems with only local HSM and backup 
and the other for systems witli local and network HSM and 
backup. 



Table 13-1 Recommended Order of Procedures in crontab 



System with local HSM System with local and network 

and backup HSM and backup 





1 . Client: periodic stage out 


1. Seiver: emvck 


2. Seiver: emvck 


2. Seiver: periodic stage out 


3. Server: periodic stage out 


3. Sen'er: compaction 


4. Server: compaaion 


4. Seiven liaseline backup 


5. Seiver: baseline backup 


(optional) 


(optional) 


5. Seiver: regular backup 


6. Seiver: regular backup 




7. Client: backup 




8. Seiver: database liackup 


The remainder of this section provides additional detail for 


these activities. 




Backup automatically performs 


baseline backups before regular 


backups, and in sites with HSM 


clients, perform a database 


backup last. You only need to t 


chedule client backups (step 7) 



after the server backup (step 6) in sites with HSM clients. 



Client (Periodic Stage Out) it is always best to stagger your network client's periodic 

staging runs so tliat their activity does not overload the network 
or the server. If, however, you stage multiple clients simulta- 
neously, performance improves if the clients stage to different 
server disks. 
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Note: You should configure a larger delay factor (closer to 
twenty miniitevs) for older and slower hardware witli 
large files or a large numbers of files. 

If a client system has more than one stageable filesystem, 
stagger the staging of each filesystem by 12 to 20 minutes. It is 
especially important to set this delay factor on filesystems that 
contain large flies of more than one MB. Running more than 
one staging operation simultaneously can degrade throughput. 

The following entiy in root's crontab file starts a new staging 
day at 12:15 every night: 

15 0 * * * /bin/kill -HUP 'cat /usr/epoch/etc/mal/eirimasterd.pid' > /dev/null 2>&1 

Refer to "Periodic Staging and Filesystem Delay" on page 11-22 
for further information. 



Server (emVCk) The emvck (volume check) program reads filesystem infor- 

mation on magnetic disk and compares it to the database. If the 
results for a staging volume do not match, it generates accurate 
counts, updates the database, and logs a message. 'The 
following entry in root's crontab runs emvck at 11:45 ever)' 
night: 

15 23 * * * PATH=/usr/epoch/bin:$PATH; export PATH;emvck >/dev/null 2>&1 



Server (Periodic Stage Out) schedule nighdy pencxHc staging of all client stores. Stagger the 
staging so that the activitx' does not overload the optical libraiy 
unit. 



Server (CompSCtiOn) schedule nightly compaction of staging volumes by running 

emcompact eveiy night from root's crontab file. After tlie 
source volumes are compacted, they arc made available for 
reuse. 
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Check the message files eveiy day. If automatic compaction 
frequently fails to reach the free goal, the system may have 
reached its limit, given the number of volumes in the libraiy 
unit. Use the dbreport compaction report to determine 
whetlier there is enough stale space to reclaim, or whether you 
should add more disks to your librar>^ unit. Refer to 
"Compacting Staging Media" on page 13-28 foi- further details. 



Ssrver (BaSBllnS BSCkup) Baseline backups are run automatically before regular backups. 

The recommended baseline backup procedure is to have 
backup templates use }3oth primary and alternate trailsets, with 
botli trailsets specifying a single baseline trail. 

You can back up the sei-ver, several clients, and the seiver 
database all witliin a single backup template. 



Server and Client (Backup) ebbackup should back up the sei-ver first and then your clients. 

If you are running network HSM, it is important to back up the 
client stores on the server, before you back up the clients. The 
following crontab entry starts a backup at 10:30 each night, 
using the backup template called default: 

30 22 * * * /usr/epoch/EB/bin/ebbackup default > /dev/null 2>&1 

Refer to Chapter 14 "Start of Backup and Related Processing" 
for more information. 



Server (Backup Database) Always back up the backup databases on tlie seiver after you 

back up tlie clients. This is also die case even if you have no 
network clients, because the sei-ver is considered a "local" client 
to tine backup software. Database backups provide you with 
complete information about both the server and client backups 
and shorten disaster recoveiy time because they enable you to 
restore the database independently from the files tliat were 
already backed up. 
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By default, the backup soft^v-'are ensures tliat the backup 
database is backed up last. 



Log files reside in a non-stageable filesystem in the 
/'var/'adm/epoch directory. To prevent tlie log files from 
growing excessively, the epnewlog script, which is run weekly 
from root's crontab file, will rotate or archive a log file to a 
stageable filesystem (/usr/epoclx/adm/rotated) whenever the 
log file grows to more than one megabyte. The script rotates the 
concise log and the mntfault log using the usual Unix-style 
rotation scheme (*.0, *.2,...): 

The script arcliives the detail log permanently to 
/usr/epoch/'adm/archived using a date-based suffix. 

epnewlog does tlie following; 

1. Moves each message log file fi-om the /var/'adm/epoch 
directoiy to the /usr/ epocli/'adm/rotated directoiy. For 
example, the message log file /var/adm/epoch/concise is 
moved to /u sr/epoch/adm/ rotated/conci se . 

2. Makes each rotated log file in Aisr/epoch/adm a version.O 
file. For example, the message log I'ile shown in step 1 
becomes /usr/epoch/adm/rotated/concise.O. Each time 
cron ams tlie epnewlog script, the file suffix is incre- 
mented (.1,.2,.3) and finally deleted. 

3. Assigns a date-based suffix to the detail log file in 
/usr/epoch/adm/ archived. 

4. Creates new message files in the /var/adm directory, 

5. Restarts the syslogd process. 

For the rotated log files, tliis procedure saves an entire montli's 
woith of log data by rotating the log file names: messages.O -> 
messages. 1 -> messages.2 -> messages.3 -> deleted. Because 
the messages. [0-3] log files are in the /usr filesystem and are no 
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longer growing, they are now candidates for HSM to staging 
devices. Use a similar approach if you've configured any other 
log files. 



Working with Individual The HSM Configuration interface handles data among several 
FilSS layers in a storage liierarchy. However, the software also 

provides command-line tools for manipulating individual files. 

The following procedures describes these tools: 

• Staging out files 

• Staging in a set of files 

• Tagging a set of files for hiture stage out 

• Locking a file on magnetic disk 



During normal system use HSM manages staging for you. There 
are times, however, when you know that a group of files is no 
longei- needed. For example, when you finish a project, you can 
explicitly stage those files out. 

Use the emstage command to stage out or prestage one or 
more files. The following example stages out tlie files, drawingl 
and clrawing2: 

emcl emstage drawingl drawing2 

There are command line arguments that let you prestage files, 
to recursively descend subdirectories wliile staging, to follow 
symbolic links, to stage to a particular volume, and to stage to a 
volume that contains a particular file. See the emstage man 
page for details. 



If you know that a group of staged-out files are needed soon, 
you can use the embsi command to stitge them in. 'Ilie embsi 
command stages the files in and attempt to make tliem all 
resident on magnetic disk. 



Staging Out Files 



Staging In a Set of Files 
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By default, embsi does not attempt to stage in files if there is 
not enough available space for them on magnetic disk. Also, by 
default, embsi does not update access times. To force embsi to 
stage in files even if not enough magnetic disk space is 
available, use the -f option; to update access times, use the -a 
option. 

When access times are not updated, embsi estimates available 
free space; when access times are updated, embsi estimates the 
total disk space in the filesystem. If not enough space is 
available, embsi displays the amount required and its estimate 
of the amount available. You can select a smaller set of files to 
stage in, explicitly stage out files, or force tlie stage in. 

Forcing a bulk stage in, when there is not enough space, almost 
certainly means that HSM will have to stage out some files. If 
the access times are updated, the chances are that many of the 
files that are being staged in remain on magnetic disk and other 
files are staged out. If the access times are not updated, tlie 
chances are that at least some of the files being staged in do not 
remain on magnetic disk. 

The following example recursively stages in all the files in the 
current directory': 
emc% embsi -r . 



Use emchmod -C to tag files so that they are staged out at the 
next convenient time, which is usually tlie next periodic staging 
run. Remember that, emchmod, unlike chmod, clears 
properties if they are not specified on tlie command line. 
Therefore, you should always use emls -1 first to determine the 
properties that arc already set. You must be superuser or the 
owner of the file(s) to change properties. 

To tag a set of files for future stage out: 
1 . Change to tlie directory that contains the files you want to 
stage out. 
emc# cd archive 
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2. Use emls -1 to determine the properties that are already set. 
emc# eials -1 * 



Mag KB Stg KB I-flags Flaqs Staging media Volume barcodes Filename 

1024 0 0 1—- 60 - filexyz 

24 898 0 0 #002-a Archive fileabc 

1 0 --CK 60 0 - dirabc 



3. Use emchmod widi the -C option to indicate that the 

specified files should be staged out at the next convenient 
time. Cllie -P option sets the residence priority.) 
emc# eiBchmod -C -P36 filexyz 



Locking a File on Magnetic use emchmod -l to lock file(s) on magnetic disk and prevent 

Disk the files from being staged out. Remember that, emchmod, 

unlike chmod, clears properties if tliey are not specified on tlie 
command line. Tlierefore, you should always use emls -1 first to 
detemiine the properties that are already set. You must be 
superuser or the owner of die file(s) to change properties. 

To lock a file on magnetic disk: 

1 . Change to the directoiy that contains the subdirectory or 
files you wish to lock on magnetic disk. 

emct cd archive 

2. Use emls -1 to determine the properties tliat are already set. 
emc# emls -1 * 



Mag KB Stg KB I-flags Flags Staging media Volume barcodes Filename 

1024 0 0 60 - filexyz 

24 898 0 0 #002-a Archive fileabc 

1 0 — CK 60 0 - dirabc 



3. Use emchmod with the -1 option to lock the specified files 
on magnetic disk. 
emc# emchmod -1 filexyz 
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Consider locking down VxFS reserved files. Resei-\'ed files are 
configured on VxFS to remain on the magnetic disk, so they are 
good candidates for locking. See tlie VxFS documentation for 
information on resen'ed files. 

Locking too many files can seriously impact HSM performance. 
Before you lock files onto magnetic disk, try small changes to 
the residence priorit\^ (see the emchmod man page). Be careful 
about setting the inheritable lock property on a directory. All 
files and directories created below that point inherit the lock 
propeity. 



Checking the Staging Use the emclieck command to check the staging configuration. 

Configuration you must be superuser to run emcheck. If you t\'pe the 

command without any arguments it checks the configuration 
database, warns you of potential problems and corrects incon- 
sistencies. If you use the -v switch (verbose) you see more 
information. If you use the -r switch (read-only), emcheck 
does not correct any problems that it may find. 

The emcheck command checks the database in eight phases. 
The first four phases, D1-D4, verily^ the semantics and the 
syntax of the configuration database. Tlie second four phases, 
S1-S4, verify the system as a whole. 

The emcheck command displays the following lines: 
beta# /usr/epoch/bin/emcheck 

*** Phase Dl - Checking configuration database files 

*** Phase D2 - Checking status of Epoch Migration servers 

*** Phase D3 - Checking store database against server config 

*** Phase D4 - Checking status of stores 

*** Phase SI - Check Epoch Migration directories 

*** Phase S2 - Check for running Epoch Migration daemons 
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Copying and Moving Data With HSM you have the ability to store vast amounts of data 

throughout your network. Often you may find the need to copy 
or move data from one location to anotlier - between 
filesystems, netv^'ork clients, or servers, for example. This 
section provides step-by-step insti-uciions for copying and 
moving large amounts of data between various locations in your 
network. The topics are: 

• Migrating data from one staging Q-ail to another 

• Copying files from one filesystem to another 

• Moving and copying files between HSM systems 

• Copying files between network HSM clients 

• Copying files to a non-EDM system 



Migrating Data from One After youVe had your system for a while, you may want to 

Staging Trail to Another archive some older data to tape or optical disk. To do this, use 

the restage command on the EDM server to migrate files from 

one staging trail to anotlier. 

1. I3ecide which staging trail you want to restage the data to. 

2. If necessary, create a new staging template/trail with the 
emstconf command. 

3. Use the restage command to migrate the data from the 
existing staging trail to the new one. 

The following command moves staged files from tlie doc 
trail to the tapel_trail. Tlie command moves only those files 
that haven't been modified or accef«ed in the la.st 30 days. 
# restage -t tapel_trail -R /datal -mtime +30 \ -atime +30 -staged_to_trail doc 

See the restage man page for additional examples. 
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Tlie fastest, most efficient way to move or copy large amounts 
of data from one filesystem to another is with tlie ebcp 
command. Tlie ebcp command copies files from one place to 
another within an HSM-enabled system, between HSM-enabled 
systems, or from an HSM-enabled system to a non-HSM system. 

Tlie ebcp command automatically determines whether the 
destination filesystem is under IISM control. If so, ebcp copies 
the files that are not staged out to the new location. In addition, 
ebcp will create a filesystem entry for staged-out files and 
attach these entries to their staged images. If the destination 
location is not under HSM control, ebcp will copy ever>?thing, 
including the files that are staged out. 

When copying to a filesystem that is not under HSM control, 
you must be sure tliat enough space is available to hold all of 
the files that are copied. 

The following example copies all of the files in llie /datal 
filesystem to the /clata2 filesystem on the same HSM-enabled 
system: 

1 . Change to the source directory; 
emc# cd /datal 

2. Use ebcp to copy the files: 
einctt ebcp . /data2 

After you copy tlie files, you can delete the originals. 



There are r^'o general approaches to copying files fx;tween 
HSM-enabled systems. Both approaches use the ebcp 
command. In the first approach, you simply copy all of the files 
and directories from one fileserver to another, including every- 
thing that is staged out, without transfeiring the staging media 
to tlie new fileserver. 



Copying Files from One 
Filesystem to Another 



Moving and Copying Files 
Between HSM Systems 
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In the second approach, you copy only the magnetic-resident 
data to the new fileserver and tlien reattach to the staging 
media, lliis second approach is significantly faster and is 
especially recommended when the quantity of data is too great 
to ti-ansfer over the network. 



Copying Files to Another HSM The following example copies all of the files, including tlie files 

System (No Media) that are staged out, in the /datal filesystem on a system named 

"emc" to the /data2 filesystem on a system named "emc2." This 
example will work on any system configured for HSM 
(fileservers and clients). 
# ebcp -o /datal | rsh emc2 /usr/epoch/bin/ebop \ -i /data2 

Note that ebcp does not update directory modification and 
access times, unless you issue the command a second time, 
using the -dlr switch. See the ebcp man page for detaUs. 



Moving Files to Another EDM (Media The following example copies all of the files that are not staged 
Included) out from the /data] filesystem on a system named emc to the 

/data 2 filesystem on a system named emc2. This example uses 
the -local switch so that ebcp reattaches files to tlie imported 
staging media ratlier than copy the staged-out files. 

1. Insert all of the source machine's staging media into the 
inlet of the destination machine's library unit. Do no! press 
any of the buttons on the front of the library unit. 

2. Use the Libraiy Unit Manager to import all of the volumes. 

3. Run ebfs_import -a to complete the import. 
enic2# /usr/epoch/bin/ebf s_iniport -a 

4. Use ebcp to copy the files that aren't staged out to the new 
system and to reattach staged-out files to their staged 
images. Note that this example only works with the primary 
staging media. Tlie secondary staging media (the baseline 
backups) cannot be moved, (llie -R IS switch, which tells 
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ebcp not to copy the baseline information, is actually an 
option to recxcpio. See the recxcpio man page for 
details.) 

emct ebcp -o -local /datal | rsh enic2 \ /usr/epoch/bin/ebc3p -i /data2 -R IS 

5. After tlie copy has completed, you can delete tlie files on 
the source machine. 



It is also possible to copy a large set of files, or an entire 
filesystem, from one network client to another. You can use 
ebcp to copy tlie magnetic-resident files to the new client and 
simply diange the ownership of the client store from one 
system to anotlier. 

Note: If otiier filesystems are staging to the store, you 
need to repeat this procedure for each filesystem. 

I'he procedure is as follows: 

1. Bring die source filesystem to an inactive state. 

2. On die EDM, use emschs to change the ownersliip of the 
client store from the source to the destination client. 
The following command changes the ownership of the 
alpha_all store to a network client named beta: 
emc# emschs alpha_all -c beta 

3. On the EDM, use emsmvs to change tlie name of the store 
from alpha_all to beta_all: 
erac# emsnivs alpha_all -n beta_all 

4. If necessary, create a staging template on the destination 
system and configure the destination filesystem for staging. 

5. Copy all the files from the datal filesystem on tlie network 
client named alpha to the /datal filesystem on tlie network 
client named beta: 

alpha# ebcp -o -local /datal | rsh beta \ /usr/epooh/bin/ebcp -i /datal -R IS 

6. Repeat the procedure for all other client filesystems that 
stage to the same client store. 



Moving Files Between HSM Clients 

(Store Included) 
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7. After the copy completes, delete the files on the source 
machine. 



Restoring a Staged Out File when a file is staged out from an HSM client to a client store, 
That Has Been Deleted the bltfile gets baclced up by the fileserv'er's backup, and the file 

attributes tliat remain on the client get backed up by tlie client 
backup. If someone deletes the file, both the attributes on the 
client and the bitfile on the fileserver are deleted. You will not 
be able to access the file's data until the attributes have been 
restored on the client and the bitfile has been restored on the 
fileserver. 

To restore the staged-out file: 

1. On tlie client run edmrestore to start the EDM Restore 
window. 

2. Select the client and work item. 

3. Select the deleted file from the list. 

4. Veriiy the destination and start tlie restore. 

5. Run emsundel on tlie EDM seiver to restore the bitfile. 
emct emsundel 

emsundel by default restores all deleted stores that have 
been recovered. Tlie command should be run regularly 
from an entry in the root's crontab file. If you can wait, let 
the emsundel crontab entry restore tlie bitfile. The 
emsundel man page describes how restrict emsundel to a 
single store and force it to use a specific backup template. 



It is also possible to use ebcp to copy data from an HSM- 
enabled system to any Unix system, 'lliis example copies all 
files in the /datal filesystem, including the files that have been 
stiiged out, on a system named "emc" to the /tmp/output 
filesystem on a system named "colt." 
I. Change to the source directory: 



Copying Files to a Non-EDM 

System 
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emc# cd /datal 

2. Mount the destination filesystem on your EDM: 
emc# mount colt : /tmp/output /mnt 

3. Use ebcp to copy the files: 
einct ebqp . /mnt 

4. After the copy has completed, you can delete the files in the 
source filesystem. 



A/loiiitoring Storage Space iism provides several tools that enable you to monitor storage 

and File Sizes space and file sizes. These tools are listed in Table 13-2. See the 

man pages for further infonnation. 



Table 13-2 Monitoring Commands 



If you want to: Use this command: 



Show magnetic disk space used by direc- 


emdu 


Sliow magnetic disl< space used by direc- 


emdu -a 


tories and individual files. 




Sliow virtual storage space used hy staged- 


emdu -av 


out directories and files; also shows 




magnetic dislv space used by magnetic- 




resident directories and files. 




Find out what staging volume a file I'esides 


emis 


on and show file sizes on magnetic dislc and 




staging media. 




Sliow information about used and available 


df 


disl< space for each filesystem. (Syntax and 




display may vaiy from system to system.) 




Show information about used and available 


df-g 


inodes for each filesystem. (Syntax and 




display may vaiy from system to system.) 
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Table 13-2 Monitoring Commands (Continued) 

If you want to: Use this command: 

List all the volumes in a staging trail and dbreport appl_usage 

obtain information about current staging 

volumes. 

Determine which staging volume to dbreport compaction 

compact. 

Display vimial filesyslem statistics, emfsreport 



Maintaining Non- The root filesystem and the filesystem tliat contains the EDM 

Stageable Filesystems software cannot be configured for HSM because they contain 

files that must not be staged out. Tliese and any otlier non- 
stageable filesystems can tlierefore fill up. 

The most likely reason that these filesystems would fill up is 
some sort of unexpected activity, either accidental or deliberate. 
If a filesystem becomes full, find files that can be deleted and 
detemiine why usage is increasing. Do the following to 
determine the cause of the problem: 

• Use ps to detennine what processes are running and kill 
any unexpected ones. 

• Look at Amp and /usr/tmp and delete any unnecessary 
temporary files. 

• Use find to look for new files in the root filesystetn. 

• Examine the LISM log files in /usr/epoch/adm/archived. 



Managing Your Magnetic If a filesystem is constantly staging files in and out, it may have 
Disks an inadequate working set. The working set is the amount of 

stageable magnetic data that a filesystem can hold without 

exceeding its low watermark. 
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Tlie working set is often measured as the number of days worth 
of files that are stored on the magnetic disk. Tliis is called the 
working set in days. For most non-archival applications, you 
should have a working set period of at least one to four weeks. 
If your working set of files is considerably larger than your 
actual magnetic disk space, you will experience system perfor- 
mance degradation. 

Use the emfsrepoit tool to display virtual filesystem statistics 
and to develop a coherent strategy for managing your magnetic 
disks: 

1. Run enifsreport to display virtual filesystem statistics. 

2. Decide how many days wortli of data you need to keep on 
the magnetic portion of a filesystem. 

3. Determine the additional magnetic disk space you'll need. 

4. Reconfigure your magnetic disk usage or purchase more 
disks, 

These steps are described in detail below. 



Use emfsreport to find out your working set size and the 
working set in days, so that you can fine tune your system. To 
run emfsreport, become root and specif}' either the name of a 
locally mounted filesystem, or use the -a switch for all 
filesystems. For example: 
emc# emfsreport -hva /data2 

A sample report is shown in Figure 13-1. It displays die amount 
of space used by all files in the /'data 2 filesystem, regardless of 
their location. (Note that virtual space takes into account space 
consumed on magnetic disk plus space consumed on the 
staging media.) 
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emfs report Output 



SPECIAL I SYMLNK 



Number of files | 


218502 1 


105169 1 




17160 1 




0 1 




96173 


GB of stagable data | 


0.33680 1 


0.33680 ! 


0 


00000 1 


0 


00000 1 


0 


00000 


GB of not stagable | 


0.11482 1 


0.00511 1 


0 


01800 1 


0 


00000 1 


0 


09171 


GB of data staged | 


1.20944 1 


1.20944 1 


0 


00000 1 


0 


00000 1 


0 


00000 


Virtual GB of data | 


1.59146 1 


1.48775 1 


0 


01800 1 


0 


00000 1 


0 


09171 


Stagable Vir-Phs ratio i 


4,743:1 1 


4.417:1 1 




000:1 1 


1 


000:1 1 


1 


000: 1 


Actual Vir-Phys ratio | 


3.537:1 1 


4.351:1 1 


1 


000:1 1 


1 


000: 1 1 


1 


000: 1 



GB available for working set: 
{About 5.6 days worth.) 



Histogram of virtual space by 
Range of days old | count | % 



Kbytes 



files : 
% I cum ' 



128 • 
256 ■ 
512 • 



15. 99 
31. 99 

63.99 

127. 99 
255. 99 
511. 99 
1023. 99 



14489 
4746 
3778 
6572 

1738 
3679 
7687 
41762 
13370 
5789 
1544 



7.31 
39.71 
12.71 



13.78 
18.29 
21.88 
28.13 
29.78 
33.28 
40. 59 
80.30 
93. 01 
98.52 
99.99 



158394 
58962 
69728 

106640 
39844 
88144 

221259 



162142 
122504 
44013 



14.18 
31.29 
10. 39 



ID. 15 
13.93 
18.40 
25.24 
27.79 
33.44 
47.63 
78.92 
89.31 
97.17 
99. 99 



Choose the Desired Working using the values displayed in Figure 13-1, you can calculate 

Set in Days how much more magnetic space you would need for a desired 

working set size in days. Figure 13-1 shows that /data2 has 353 
MB available in its working set, with a working set in days of 
5.6 days. Once you learn what your working set size in days is, 
you may decide that it is too small. (Remember, EMC recom- 
mends you have a working set period of at least one to four 
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weeks.) Select an adequate number of days based on your 
usage patterns. See "emfsreport and the Worldng Set" on page 
11-31 and "'Disk Utilization Zones" on page 11-13 for some 
additional considerations. 



Determine Additional The sample report of /data2 shows that the filesystem has a 

Magnetic Disk Space Required working set of 5.6 days, suppose that is unacceptable and you'd 

rather have a working set of 14 days. How much additional 

magnetic disk space would you need? 

To estimate, simply pick the high day range that falls closest to 
your desired working set size. In this case the day would be 
15.99. 

1. Multiply the value on the "Kbytes cum%" line (27.79) by the 
total number of Kbytes (156(X323) to get tlie working set 
size in KB. For example: 

Working set size in KB = .2779 * 1.560,023 
The result is 433530.39 KB. 

2. lake the result of tlie previous calculation (433530.39) and 
divide by 1024 to get the working set size in MB. 
Working set size in MB = 433530.39/1024 

The result is 423.37 MB. 

3. lake the result of the previous calculation (423.37) and 
divide by 1024 to get tlie working .set size in GB. 
Working set size in GB = 423.37/1024 

The result is 0.41 GB. 

4. Subtract the GB available for the working set (0.353) from 
0.410 and multiply by 1024 to get the number of additional 
magnetic space needed in MB. 

Mag Disk Space needed = (.410 - .353) ' 1024 
The result is 58.37 MB. 
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Thus you would need approximately 58.37 Mbytes moi'e 
magnetic disk space on this filesystem in order to have a 
working set of 15.99 days. (You can extrapolate to find tlie 
exact requirements for a working set size of 14 days.) 



Reconfigure Magnetic Disk or Depending on your site's configuration, your budget, and the 
Purchase fVIOre Disks amount of time you have, there are a number of actions you 

can take to better utilize your magnetic disk resources; 

• Move files to another filesystem that is under utilized. This 
filesystem may be on the same or on another magnetic disk. 

" Repartition your disk. Take a complete backup of your 
filesystems, repartition your disk and restore your files. 
When repartitioning your disk, make die partitions corre- 
spond to their working set needs-, make some partitions 
smaller and some larger. 

• Add magnetic disks if you are using all of your current disk 
space and have no where else to relocate the files. 



Populating Filesystems The most efficient way to move files from a non-HSM system to 
an HSM system is to make the HSM system an NFS client of the 
other system and to use taf to read the data. For example, to 
copy /user! on another system to /datal/u.serl on the HSM 
system, use the following procedure: 

1. Configure the other system as an NFS server for its /userl 
filesystem. 

2. Login to tlie IISM system as root, make a temporary' 
directory, and temporarily mount the server's /userl as a 
remote filesystem: 

emc# mkdir /other_userl 

emc# mount -o , ro , hard , intr serv: /userl /otlier_userl 
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3. Cliange to the remote filesystem and use tar in a pipeline to 
copy files to the new filesystem on the HSM system. Then, 
unmount the remote filesystem and delete the temporaiy 
directoiy: 

emct mount -F vxfs -o remount , nolog /datal 
eiBct cd /other_userl 

emc# tar cBf - . | (cd /datal/userl ; tar xBpf -) 

emc# cd / 

emct iimount /other_userl 
erac# rmdir /other_userl 

An HSM-enabled system can also be populated by configuring it 
as an NFS seiver, configuring the other system as the client, and 
using tar on the client system to "push" the files to the HSM 
system. Because NFS read performance is generally better tlian 
NFS write performance, the best approach is to make the I^SM 
system the client and "pull" the files from the ser\'er. 

When populating an HSM system with archival files, that is, files 
that you want to move quickly to staging media, you can set the 
convenient property (-C) on the directory that contains the files. 
Then, any file loaded into that directory (or subsequently 
created subdirectories) will be staged out during the next 
periodic staging run. See tlie emchmod man page for defciils 
about the convenient property. 

For details on moving data from one EDM to another, see 
"Moving and Copying Files Between HSM Systems" on page 
13-14. 



Disabling Filesystem There are two ways to disable staging. You can temporarily 

StSging disable periodic staging for an entire system, for a staging 

template, or for an individual filesystem. Or, you can perma- 
nently disable both periodic and demand staging. 
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Temporarily Disabling Periodic By changing the enable value from Y to N in eitlier tl-ie 
Staging emsysconf command, the emstconf command, or the 

emfsconf command, you can temporarily disable periodic 

staging for an entire system, for a staging template, or for an 

individual filesystem. 

emcf emsysconf N 20R 

emc# emstconf CAD n ----- - -OR 

emc# emfsconf /mech N - - - - CATOR 

See the man pages for details regarding command syntax. 

The enable value only affects periodic staging; it has no effect 
on demand staging (crossing a high watermark), user-specified 
staging (emst^e and restage), baseline backup, or stage-in. 



Permanently Disabling use the following procedure to permanently disable filesystem 

Periodic and Demand Staging staging, that is, periodic and demand stage-out and stage-in. 

This procedure not only disables staging, but it also stages in all 
staged-out files. If the filesystem does not have the room, you 
can move the staged-out files to another filesystem. See 
"Copying Files from One Filesystem to Another" on page 13-14. 

To preserve data integrity, you must follow this procedure 
exactly as described. 

1 . Make sure you have a valid set of backups for the 
filesystem. 

2. Become supeaiser. 

3. Change permissions on the root of the target filesystem to 
allow only ni>x access by root. (Before you change the 
permissions, do an Is -lad to determine what the current 
permissions are. You reinstate these permissions at a later 
date.) 

emc# Is -lad /alpha 

drwxr-xr-x 9 root 512 Sep 4 15:40 /alpha 
emc# chmod 700 /alpha 
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4. Disable periodic and demand staging. Note that tliis step 
prevents periodic and demand staging, but it does not 
prevent users from staging specific files. At this point, users 
can still access staged out files. 

emc# emfsconf -r /alpha 

5. Disable compaction by commenting out or editing the 
appropriate line in root's crontab file. The default 
compaction line is as follows: 

00 1 * * * /usr/epoch/bin/emcompact -c 
>/dev/null 2>&1 

In addition, abort any compactions in progress. 

6. Disable baseline backups from the Backup Configuration 
interface. 

c. From tlie EDM main view's Backup menu, select 
Configure. 

d. On the Sender tab select Disable baseline backups. 

e. Select Save, then exit EDM. 

7. Shutdown the system and then reboot. Tliis ensures that no 
one is logged in and severs any remote connections to the 
system. 

Note: Use only /usr/sbin/sliutdown -y -16 -gO 

on an HSM system. Do not use halt or reboot. 

8. Use emfsreport to determine whether enough free space 
is available to stage in all of the staged-out files. The 
important line to look at in the emfsreport display is die 
Virtual GB of data (239-35 MB, in this example); 
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einc# emfsreport /alpha 



/alpha I TOTAL 1 REGULAR | DIR | SPECIAL I SYI 



Number of files | 




16701 1 




5799 1 




1818 1 




0 1 






GB of stagable data | 


0 


20034 1 


0 


20034 1 


0 


00000 1 


0 


00000 1 


0 


0 


GB of not stagable 1 


0 


01340 1 


0 


00288 1 


0 


00185 1 


0 


OODOO 1 


0 


0 


GB of data staged | 


0 


03130 1 


0 


03130 i 


0 


00000 1 


0 


00000 1 


0 


0 


Virtual GB of data 1 


0 


23935 1 


0 


22884 1 




00185 1 


0 


00000 1 


0 


0 


Stagable Vir-Phs ratio | 


1 


195:1 1 


1 


142:1 1 


0 


000: 1 1 


0 


000: 1 1 


0 


0 


Actual Vir-Phys ratio 1 


1 


120:1 1 


1 


126:1 1 


1 


000: 1 1 


0 


000:1 1 


1 


0 



GB available for working set: 0.230 
(About 572.1 to 739.6 days worth.) 
(Range given because 1% of virtual space 

9. If you do not have enough free space to stage in all of die 
staged-out files, refer to the following section. 

10. Run emfsdeconfig to complete the procedure. 
emc# emfsdeconfig /alpha 



Moving Staged Out Files to if the filesystem does not have enough space to hold all of the 

Another Filesystem staged-out files, proceed as follows: 

1 . change to the /alpha directory. 

2. Use ebcp to copy the files to another filesystem, which may 
be stageable or non-stageable. The following example 
copies all of the files in /alpha to /new_a]pha. 

emcl ebcp . /new_alpha 

3. Delete tlie files in the /alpha filesystem. 

4. Unmount the /alpha filesystem to clear data structures used 
for stageable filesystems. 

emcl rnnount /alpha 

5. Recreate the /alpha filesystem. 
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In most cases, staging media is compacted automatically via an 
emcompact entry in root's crontab file. With automatic 
compaction, emcompact automatically determines which 
volumes to compact. 

You can also compact staging volumes manually, if you want to 
compact any additional volumes. Both automatic compaction 
and manual compaction use the emcompact command. 

If you need to compact some staging volumes manually: 

1. Use dbreport's compaction report to decide wliich 
volumes to compact. 

emctt dbreport compaction 

The compaction report is divided into three sections. The 
most likely volumes to compact are tliose that are listed in 
the last few lines of the first section. Tliese are the volumes 
with the highest percentage of stale files. 

2. Use emcompact to compact tlie volumes. In the case of 
EOs, which have two sides, you need to specify each side, 
or volume, separately. You can specify volumes by: 

- volume id 

- sequence number (for single-sided media) 

- sequence number and side (for double-sided media) 

- barcode (for single-sided media) 

The following example compacts both sides of disk #10: 
emc# emcompact EO 10-1 10-2 

You can type the command without any arguments to find 
out the legal media types. (In the case of tapes, you can 
specify a barcode.) 

You can override HSM's file residence policy by running 
emcompact with the — p (policy) option. The -p option 
ensures that all files from tlie compaction source volume 
are staged out to the compaction output volume and none 
remain on magnetic disks. 
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Administering Compaction There are several things you can do on a regular basis to make 

sure that compaction is working smoothly. 

CAUTION: In order to ensure a complete file restore 
process, you should disable automatic 
compaction and enivck as soon as you realize 
that you've lost a filesystem or a significant 
portion of one. 

• Check tlie Media Requests wrindow every morning to see if 
automatic compaction has blocked. 

• Keep a supply of blank, easily accessible and unlalieled 
volumes, which you can label and allocate as compaction 
output volumes. 

To increase the likeliliood of maintaining a supply of free 
volumes, you can also convert unrestricted staging trails to 
restricted ones, or prelabel volumes for a specific trail. 

• Check the message files eveiy day. 

If automatic compaction fi-equently fails to reach the free 
goal, the system might have reached the limit of its data 
storage, given the number of volumes in the library unit or 
the time available for compaction. 
In such a case, use tlie dbreport appl_iisage report to 
detemiine whether there is enough stale space to reclaim, 
or whether you should add more vokunes to your library 
unit. For example, in an EO system with volumes averaging 
25% stale data, you must compact four volumes in order to 
get a single free volume (see Figure 13-2). If tliis rate is 
unacceptable in your environment, add inore lilank 
volumes. Refer to EDM Sewer Etror Messages for further 
details on what to do if automatic compaction fails. 
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Figure 13-2 



Freeing Volumes for Use 

Compaction Source Volumes Compaction Output Volumes 

100% Active (full) 



75% Active, 25% Stale 



Compacting Baseline 
Media 




□ 



^ = stale Data 
r~l = Active Data 
□ = Free 



Available Volume 



Compacting baseline volumes is similar to compacting stiiging 
volumes, but you can only compact baseline volumes manually. 
Compacting baseline volumes causes all currently active data 
associated with the volume to be copied to the current 
compaction volume associated with the baseline trail. New 
baseline compaction volumes are allocated as necessary. 

As a general goal, you should limit die number of active 
baseline volumes to the number of active staging volumes. If 
possible, you should also limit the number of active baseline 
volumes to the number of slots in your libraiy units. This facili- 
tates recoveiy in the e¥ent of a site disaster by ensuring diat all 
of the baseline media (to which active files are attached) will fit 
in your library units. 

To compact baseline volumes: 
1. Run dbreport baseline weekly and refer to the "pct_stal" 
column for baseline volumes. 
emc# dbreport baseline 
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2. Use emcompact to compact tlie most stale optical disks 
or tapes. (In the case of optical disks, there are uvo 
volumes per disk.) Tlie value of iV varies, but it is at least 
the number of active baseline media minus the number of 
active staging media or slots Ln your librar}? units, whichever 
is less. 

Therefore, if you have 55 active baseline media, 45 active 
staging media, and a 50-slot library unit, compact at 
minimum the ten most stale baseline media. 
This results in a set of compacted baseline volumes. Note 
that these volumes are not deallocated and available for use 
until all existing baseline-relative backups that reference 
them expire. 



CISSring InCOmplStS as pan of nlghtly maintenance, the system runs the emscheck 

BitfiISS pi"Og'"'i""' via root's crontab to clear the incomplete bitfiles that 

accumulated in the client stores as a result of an interruption of 
service during a stage-out. 

For example, tlie following line in root's crontab runs 
emscheck every day at 12:30 a.m.: 

30 0 * * * /usr/epoch/bin/emscheck >/dev/null 2>&1 



Moving S Store to Another To move client stores from one EDjM server to another, do the 

EDM Server following: 

1 . Use the etnschs command to freeze the client store. 

einc# emschs alpha_all -z 

Store Name 
Freeze Store 



2. Use the ebcp command to relocate the entire contents of 
the store. Note that you must copy totli the magnetic and 
staged out data. Tlie following example copies all of the 
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files, including the files that are staged out, in the /alpha_ai] 
store on a system named "emc" to the /alpha_new store on 
a system named "emc2." 
emc# cd /stores/alpha_all 

enic# ebcp -o . | rsh enic2 /usr/epoch/bin/ebcp 
-i / stores/ alpha_new 

3. On the new seiver, emc2, use emsmks to add the store to 
the server configuration. 

eiiic2# emsmks alpha_new -p /stores/alpha_new -c alpha_new 

Directory /stores/alpha_new already exists, reuse [ y/n] ? y 
Store configuration data already exists, reusing, 
emsd is running, restarted..! OK] 

4. Unfreeze tlie store on the new server: 
emc2# emschs alpha_new -w 

5. Notify die client system of the store's new location. Note 
that in this case trail_l is the name of the previous staging 
trail. 

alpha# emstconf trail_l ------ emc2 : alpha_new 

6. Add the new migration tag on the new server: 
emc2# emschs alpha_new -t new_m±gration_tag 

7. Remove the old store from the original server: 
emc# emsrms alpha_all 



Gathering Migration Store use the emsstat command to display network migration sender 

Statistics actlvitv' levels. The emsstat command gets its information by 

accessing statistics tliat are kept in a shared memoiy segment 
used by all active EDM Migration server daemon (emsd) 
processes, or from a statistics file if emsd is not running. 

If you type emsstat without any arguments, it displays statistics 
representing server activity since the statistics were last cleared. 
If you use the -i option, emsstat displays the ongoing server 
activity', and, by default, updates the screen in 10 second 
intervals. 
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To reinitialize die statistics database enter the following 

commands: 

emc# emshalt 

emc# rm /usr/epoch/etc/mal/emsd_stats 
emci ems start 

See the emsstat man page for further details. 



Checking a Network use the emcheck command to check the EDM Migration client 

Client's Staging configuration, you must be superuser to run emcheck. If you 

Configuration ^'P^ command without any arguments it checks the config- 

uration database, warns you of potential problems and corrects 
inconsistencies. See "Checking flie Staging Configuration" on 
page 13-12 for more information. 



Troublesliooting HSM IISM depends on the interaction of several daemon processes. 

Most HSM problems are caused by tlie failure of one of these 
processes. The following checklist enumerates the steps to take 
to ti-oubleshoot HSM pi-oblems. (Use the emllstd command to 
check whether any of the following processes are running.) 

□ Verify that the HSM file monitor daemons (emfmd) are 
running. 

□ If you are unable to stage in files, verify that the stage-in 
daemons (emsid) are running. 

□ If demand or periodic staging fails, verify that at least one 
master daemon (eniniasterd) is running. 

□ If tlie user-level commands (emstage, embsi, emchmod, 

and emls) are failing, verify- that the HSM RPC daemon 
(emrpcd) is running. 

□ Look in the /var/adm/epoclVdetai] log for error message 
information. 
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Restoring a Lost or The procedures for restoring a lost or damaged staging volume 

Damaged Staging Volume vaiy, depending on whether or not baseline backup is installed. 



If baseline backup is not enabled: 

1. Use the dbreport volumes report to find the vol ids of the 

missing volume(s). (The volid is a l6-digit hexadecimal 
number.) I^'or two-sided media, you need to get the volids 
of both sides. 

2. If tine lost volume happens to be the current staging 
volume, the cun'ent compaction volume, or an active 
backup volume, you need to use em_new_volume as 
follows: 

emc# ein_new_vo liime staging_trail_name 

3. Locate the files staged to the missing volumes by using 
emlindd): 

emc# emfind / \( -staged_to 0000111122223333 -o\ -staged_to 0000111122223334 \) - 
print > /usr/tmp/f iles 

Note: If emfind encounters a pathname that is too long, it 
generates an error message. The pathname is not 
added to /usr/tmp/files, and the subsequent restore 
are incomplete. Some manual intervention 
(descending into directories and rerunning emfind) 
is necessary in such cases. 

4. Delete tlie missing volumes from the database using 
evnmnvol; 

emc# /usr/epoch/bin/evmrmvol -v 0000111122223333 
emc# /usr/epooh/bin/evmrmvol -v 0000111122223334 

5. Restore necessar}' files: 

emc# ebrestore -D server -c server -w workitem -d -f /usr/tmp/files 



Restoring a Lost or Damaged 
Staging Volume (No Baseline 
Bacicup) 
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Restoring a Lost or Damaged if baseline backup is enabled, you can use cbcheck to restore a 

Staging Volume (Baseline staging volume. Tlie steps are as follows: 

Backup is Enabled) ^sing dbrepon volumes, obtain the IDs of tlie missing 

volume(s). For two-sided media, you need to get the IDs of 

botli sides. 

2. Delete tlie missing volumes from the database using 
evmrmvol: 

emc# /usr/epooh/bin/evmrmvol -v 0000111122223333 
erac# /usr/epoch/bin/evmnavol -v 0000111122223334 

3. If the missing volumes are baseline backup volumes, simply 
invalidate the pointers to the baseline volumes: 

emc# ebcheak -a -i 

4. Otherwise, if the missing volumes are primaiy staging trail 
volumes, restore as many of the files as possible from the 
baselines: 

emc# ebcheck -a -i -bl -b2 

5. Restore any remaining files from the full and incremental 
backup volumes: 

emc# ebcheck -a -rl -r2 > /usr/tmp/f iles 

6. If /usr/tmp/files is non-empty: 

erric# ebrestore -D server -c server -w workitem -d -f /usr/tmp/files 



Restoring a Lost or This method uses baseline volumes as a temporary staging trail, 

DamSgOd Staging Trail which lets you bring tlie system back up much sooner. 'The 

procedure is veiy quick, and you can generate your new 
primary staging trail wliile the system is up and providing 

service: 

1. Delete each missing volume from the database as before. 

2. Make the baseline backup volumes also act as a copy of the 
primary staging trail: 

emc# ^oheok -a -i -cl -o2 
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3. Restore any remaining files from the full and incremental 
backup volumes: 

emct ebcheck -a -rl -r2 > /usr/tmp/f iles 

4. If /usr/tmp/files is non-empty: 
emct ebrestore 

5. Using restage, generate a new primaiy staging trail for each 
filesystem as appropriate: 

emc# restage -t trailname / \( -fstjnpe nfs -prune \) \ -o -staged_to_trail 

baseline^trailname 



Restoring a Lost or These steps restore a filesystem to its state as of its last backup, 

Damaged Filesystem after a complete loss due to disk failure and the like, line steps 

assume the staging trails, backup catalogs, and the root 
filesystem all are still intact. The steps are designed to avoid all 
accesses to the filesystem while it is being restored, whether 
local or remote, so that users do not see a filesystem tliat is only 
partially recovered. 

1. Create a new empty filesystem, the same size as tlie original 
one or larger: 

# mkfs -F vxfs -o inosize=512 /dev/rdsk/cA'tMZ 

2. Mount the filesystem to a temporary location (called 
/tmp_doc in the examples below); 

# mkdir /tittp_doc 

# mount -F vxfs /dev/cXtrdZ /tmp_doc 

3. If tlie filesystem was configured for HSM, you must now 
configure the new filesystem for HSM. Tliis step must be 
done before recovering any data, or staged out files are not 
recovered correctly. 

Use the EDM HSM configLiration interface, just as if you 
were configuring a filesystem for the first time. The 
filesystem may be assigned to the same staging trail as the 
original, or to a different staging trail; it makes no 
difference. 
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4. Using the EDM Restore interface, restore the last backup of 
the filesystem you lost (called doc here) onto the new 
filesystem (mounted here at /tmp_doc). 

Mark ever\?thing in the filesystem except for die .-EPOCH-, 
and lost+found directories. 

5. Change to tlie /tmp_doc/doc directory, and move eveiy- 
thing to /tmp_doc. 

# cd /tmp_doc/doc 

# mv * /tinp_doc 

# cd . . 

# rmdir doc 

Be sure to check for files or directories whose names begin 
with "." since they are not moved by the mv command. The 
rmdir command fails with "Directory not empty" in such 
cases. The Is -a command lists these files; they have to be 
moved manually 

6. If the new filesystem (/tmp_doc) was configured for HSM, 
remove it now from the staging configuration database. 
There is no need for this configuration now, since the 
original filesystem (/doc) should still be in the staging 
configuration database. 

7. Umount the filesystem from its temporary mount point, and 
remount it under its real name. 

This example assumes that the same physical device 
address is being used for the new /doc (the usual case if a 
new disk was brought in to replace a failed one). If the 
device address is now different, be sure to update the 
/etc/vfstab entiy for tlie filesystem. 

# cd / 

# ximount /tmp_doc 

# rmdir /tmp_doc 

# mount /doc 
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Start of Backup 
and Related 
Processing 



llie EDM Backup softm^are automatically initiates backups, 
processes catalogs, and generates backup reports. You can also 
initiate these functions manually, or edit tlie crontab file to 
change how these functions occur automatically. Tliis chapter 
contains the following topics: 

• Backup Processing 

• Catalog Processing 
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BSCkUP PrOC6SSini9 Following are methods of initiating backup processing with 

EDM Backup: 

• by using die Backup Activit>^ Wizard 

• automatically from crontab (see page 14-3) 

• manually from command line (see page 14-7) 

The Backup Activity' Wizard enables you to start new, queued, 
or failed backups, stop running backiips, or manage the backup 
queue. You access this wizard from tlie Main window of the 
EDM GUI. 

Note: You must have root privileges or be an EDM 

Backup Administrator to use t!ie Backup Activity 
Wizard. 

For automatic processing, EDM Backup uses the crontab facility 
to issue the ebbackup command at a particular time each night 
to start backups. Tlie command specifies a backup schedule 
template, which contains scheduling parameters. You can create 
additional crontab entries (using the Backup Configuration 
Wizard, by editing the file, or from the Backup Configuration 
window of the EDM GUI) for any schedule templates tliat you 
add. You can optionally specify a particular work group or 
work item, backup level, or specific day with the ebbackup 
command, but you would typically use the Backup Configu- 
ration Wizard or the backup template. 

To start network backups manually, you can issue tlie 
ebbackup command from the command line. Again, you can 
choose to specify a backup schedule template, but you would 
more typically specify a particular work group or work item, 
backup level, or specific day when starting backups from the 
command line. 
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To start Symmetrix Connect backups manually after successful 
client configuration, issue the eb_dc_backup ii>ork_item 
_base_name command. Refer to the EMC Data Manager 
Symmetrix Connect User Guide for more information on starting 
these types of backups and related processes. 

Note: However you initiate backups, make sure your 
clients are configured and that you have labeled 
your media and inserted tliat media into the 
appropriate library? unit. 

For additional information, refer to "Scheduling" on page 3-4. 

The following sections describe starting backups in the crontab 
file or manually from die command line. 



Backup Activity Wizard As mentioned above, the Backup Activity Wizard enables you to 

start nev\% queued, or failed backups, stop running backups, or 
manage the backup queue. You access tliis wizard from the 
Main window of die EDM GUI. 

fi^^S^ \ Click this icon in die Main Window to start the 
C'.!=^'? Backup Activity' Wizard. 

In the wizard panels, you select a backup operation, select the 
objects on which you want to operate, choose backup options, 
and confirm your actions. You can then monitor the progress of 
the backup operation that you initiated in the Main window. 

Refer to EDM online help for more information. 



Automatic Nightly Processing you can use one of the following methods to configure the 

crontab facility' to schedule automatic backups for each defined 
schedule template in the configuration file: 

• Backup Configuration Wizard (which you access from the 
EDM Main window toolbar) 
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• Backup Configuration window (refer to EDM online help 
for more information) 

• CLI 

By default, the backup schedule template runs automatically at 
6:(X) p.m. every night. 

Note: An error message appears if scheduling a backup 
via cron is unsuccessful. 

Each line in root's crontab file has several fields of information. 
Figure 14-1 sliows Are format of the crontab entry tliat invokes 
the ebbackup program. 



Figure 14-1 Root's Crontab File Entries 

XX XX XX XX XX ebbackup backup- template (s) 

Minute J 

Hour I 

Day of Month I 

Month of Year | 

Days of Week | 

Command to Run J 

Argument(s) 

You can edit root's crontab file (/var/spool/cron/crontabs/root) 
to change when to tegin backups. If you add any backup 
schedule templates, you edit root's crontab file to specify' when 
to begin backups. 

You can also schedule a backup in the crontab file within the 
Backup Configuration window of the EDM GUI. In the window, 
you select a work group for backup and die time that the 
backup is to occur. You can also indicate whether you want to 
schedule a failed backup, or use new media for a backup. (For 
more information, refer to Chapter 2 of tliis manual, EDM 
online help, and the ebbackup man page.) 
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After you edit the file, tlie backups occur automatically. At the 
specified time each day, root's crontab file invokes the 
ebbackup command, which starts overall backup processing. 
Edit the file again only when you want to change the nightly 
backup iTjn time. 

Figure 14-2 shows a sample crontab entry, which starts a 
backup using the schedule template named "cdr-all." 

The template "cdr-all" specifies the work groups to back up and 
the trailsei to write the backups to. AsterisksC) represent 
unspecified fields. 



A Sample Crontab File Entry 



Command to Run 1 

Schedule Template Name 

The sample crontab entiy in Figure 14-2 indicates tlie following: 

• the Minute field specifies to start the backup 30 minutes 
after the hour. 

• the Hour field specifies the hour at which to start die 
backup, in tliis example, the backup will start at 10:30 p.m. 
The length of time ebbackup ains depends on the length 
of tlie shift as defined in the backup template or when all 
scheduled backups finish — wliichever occurs first. 

• the Day of Month field indicates all days of the month (*). 

• the Month of Year field indicates all montlis (*). 

• the Days of Week field indicates all days of the week (*). 



30 22 



ebbackup cdr-all 



Minute I 

Hour 




Day of Month 
Month of Year 
Days of Week 
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• the Command to Run field specifies the command 
(ebbackup). 

• the Schedule Template Name field specifies the backup 
schedule template on which to run the backup (cdr-all). 

The ebbackup command starts backups for a backup schedule 
template. By default, a backup schedule template specifies 
automatic scheduling of backups for all of the work items 
affected by it. When EDM Backup starts it uses the rotation 
period, the rotation scheme, and the backup shifts that are 
specified in the named schedule template to determine what 
work items to back up during tliat backup session. 

EDM Backup manages die backups, perfonning one full backup 
(level 0) for each work item each i-otation period, and 
scheduling level 9 backups on the remaining days in the 
rotation period. 

EDM Backup's abilit>' to automatically balance the backup work 
load frees you from the task of manually assigning each client 
to a backup schedule. Automatic scheduling also adjusts to 
clients that are down during the scheduled backup. 

You can also specify custom scheduling for the backup. In 
custom scheduling, the backup schedule template explicitly 
defines the work items and the days on which they are 
scheduled for backup. You can specify the custom schedule for 
the template within the Backup Configuration Wizard or tlie 
Backup Configuration window of the EDM GIJL 

Backups that you schedule by using the custom schedule 
directives in the backup template are initiated using root's 
crontab file to begin processing for the template, just as for 
automatic scheduling. 
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Note: If a client is unavailable on its scheduled backup 
day, the backup does not automatically reschedule 
the backup to another day as auto scheduling does. 

ft is also possible to use the cbbackup command to directly 
specify particular backup levels on certain days for certain work 
groups or work items. This alternative command format is 
described in the next section. 



Command Line Processing you can choose to initiate all backups by using the cron facility 

or command line. 

The ebbackup command enables you to specify the level of 
backup, work group, work item, priority?, and/or trailset to use 
for a backup. You can use die ebbackup switches in 
combination witli the crontab facility to schedule a command 
for a certain time each day to schedule each backup. 

The ebbackup command options are usetlil when you want to 
schedule a specific backup. For example, you may want to 
force an immediate full (level 0) backup for a particular client's 
work item before performing an operating system upgrade on 
that client. You can also use tlie command line to schedule or 
reschedule backups that have failed. Refer to the man pages for 
ebbackup for details about the available options. 

When you specify' a backup from the command line, this 
backup oveiTules any backups scheduled by automatic or 
custom scheduling. 

Note: To run a command line baclcup for a particular 
backup level, you must first define that level in a 
trailset. 

The following examples show how to use the command line to 
backup a work group, a work item, and an HSM work item. For 
more information see the ebbackup man page. 

The command line in Figure 14-3 stai-ts level 9 backups for the 
clients in the work group named "cad." 
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Figure 14-3 



Backing Up a Work Group 



# ebbackup -1 9 -g cad cdr 



ebbackup Command 
Backup Level Switch 
Backup Level 
Work Group Switch 
Work Group Name 



Backup Schedule Template Name 

The command line in Figure 14-4 starts level 0 backups for tlie 
work item named "cad-all." 



# ebbackup -1 0 -i cad-all cdr-all 



ebbackup Command 
Backup Level Switch 
Backup Level 
Work Item Switch 
Work Item Name 
Backup Schedule Template Name 



The command line in Figure 14-5 starts baseline backups for the 
HSM work item "atlas!:/" to the "off site 2" trailset. 



Figure 14-4 



Backup up a Work Item 
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Backing Up an HSM Work Item to a Trailset 

ebbackup -1 Bl -i atlasl:/ -t "off site 2" fileserver-. 



ebbackup Command 
Backup Level Switch 
Backup Level 
Work Item Switch 
Work Item Name 
Trail Switch 
Trailset Name 
Backup Schedule Template 



CstOlOg ProCSSSiflQ when a backup completes, die raw data for the associated 

catalog exists on the EDM Backup server. Tiie catalog daemon 
(ebcatalogd) must process the raw catalog before the restore 
process in the EDM Restore window or the command 
ebrestore can use it. You can have catalog processing 
performed concurrently with backups, or you can schedule 
catalog processing for a later time so that this task does not 
slow down client backups. 

Normally, the /etc/rc3.d/s30ebs script starts ebcatalogd at boot 
time. 

To exercise greater control over the catalog processing 
schedule, you can start and .stop ebcatalogd manually, or you 
can control it automatically via root's crontab file. To start 
catalog processing, run ebcatalogd without arguments. The 
catalog daemon places itself in the background when it ams, 
and terminates if another catalog daemon is already ruiming. To 
stop catalog processing, ran ebcatalogd with tlie -halt option. 

Figure 1 4-6 shows a crontiib entiy that starts catiilog proces.sing 
at 6:30 AM each day, which is after the .site's backup shift ends. 
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Figure 14-6 Starting Catalog Processing from Crontab 

30 06 * * * /usr/epoch/EB/config/daemon_startup -ebcatalogd 

Figure 14-7 shows a crontab entry that stops catalog processing 
an hour before the backup shift begins again at 10:30 p.m., the 
site specifies halting catalog processing at 9:30 p.m. 



Figure 14-7 Halting Catalog Processing from Crontab 

30 21 * * * ebcatalogd -halt 
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Logging 



llie EDM Backup and HSM software maintains a message 
logging system that uses both die system log daemon, syslogd, 
and circuiai" logs to record significant events. Tliese messages 
can be written to log files or to the system console. The 
configuration file (/usr/syslog.conl) detennines the error 
conditions that are logged and where the messages are sent. 

This chapter contains tlie following sections: 

• Message Logging Feaaires 

• Syslog Message Files 

• Circular Log Files 

• Log Message Format 

• Default syslog Configuration File 
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Message Logging The message Jogging system offers the following features: 

I cam I CO • Automatically creates log files: 

During system installation several message log files are 
created automatically. Tliese files are specified iii the 
/etc/syslog.conf file, and described iti "Default syslog 
Configuration File" on page 15-6. 

• Uses cron to mail messages to system administrators: 
For sites with a mail facility, cron starts a script that mails 
log messages which describe the system activities 
(anomalies only) for die previous 24-hour period to the 
system administrator. (See "Running Procedures Automati- 
cally via Cron" on page 2-6.) 

• Groups files into logical categories: 

The syslogd sends log messages to specific log files 
depending on the type of message. Because EDM Backup 
software groups messages into separate log files, you can 
choose to look at the log file that is most appropriate for 
the task at hand. For example, all messages that describe 
maintenance activities are sent to one particular log file, 
while messages that show error audit ti-ails are sent to 
another. 

• Monitors interaction of EDM subsystems: 

Subsystem messages work togethei" to give a complete view 
of system activity. This means that when an event occurs, 
all affected subsystems log a message. By looking at 
messages that are sent from different subsystems, you can 
see the relationship of each subsystem's activity. 



Syslog Message Files All syslog messages are written to log files that reside in 

/var/ adm/epoch . 
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Note: All of the log files, except for the daily log, are 

rotated or archived in /usr/epoclT/adm, where they 
remain for four weeks. 

The messages in these files enable you to determine flie cause 
of a system problem. The log files are named the following: 

• concise 

• daily 

• debug 

• detail 

• mntfault 

• lu_hardware 

Table 15-1 explains when to look at each message file: 



Table 15-1 



When to Look at the Syslog Message Files 



If you want to: 



Look at this file: 



deternrine quickly if any system problems have occurred. If the file is /var/adm/epoch/concise 
empty, you know the system is operating properly. You should view this 
file daily. 



see system problems for the past 24 hours. The daily log is a subset of 
the concise log. 



/var/'adm/epoch/daily 



check the debug log. Debugging must be tumed on according to the 
directions in the /etc/syslog.conf file. Iliis file is primarily for use by 
Customer Ser\'ice personnel . 



/var/adm/'epoclx/debug 



see additional information about the errors tliat appear in the concise 
log. 



/var/adm/epoch/detail 



view a list of volume requests (which i-equire operator assistance) and 
the audit trail for volume allocation and erasure. You can foiward these 
messages to other systems and/or to the system console for monitoring. 



r/adm/epoch/ mntfault 



see additional infomiation about hardware en-ors that appear in the 
detail log 



/var/adm/epoch/lujtardware 
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You can configure message logging to bypass tlie standard 
system logs and write messages to circular logs. Circular logs 
are located in a central directory or in application-specific 
directories. The following directories contain circular logs; 

• /usr/epocli/adm/circular 

• /usr/epoch/etc/'sM.&£/?recto?3' 

The names of die circular log files that are located in the central 
directors' /'usr/epoch/adm/circular are based on tlie daemon 
name. For example, the name of die circular log for die 
volume management erase daemon is vmerd.log. 

Volume management maintains its circular log in 
/usr/epoch/etc/vm. This provides the system administi-ator with 
access to all VM-related files in one directory. For this same 
reason, circular logs for each Libraiy Manager reside in 
individual subdirectories of /usr/epoch/etc/lm. 

Circular logs that reside in VM and LM directories are named 
clog (for circular log). 

You can use die fuser command to show all processes that 
have a given file open. For example: 

# fuser -f /usr/epooh/etc/lin/hp_mf_sa/clog 



Log File Rotation and Archival if you are using the migration option, the concise and mount 
faidt logs are rotated in Aisr/epoclV'adm. 

The detail and debug logs are archived in /usr/epoch/adm for 
one year in systems on wliich EDM Migration is installed. Tlie 
logs are archived in year-month .sulxiireciories as shown in the 
following examples: 

/usr/epoch/adm/1999-10 
/usr/epoch/adra/1 999-11 
/usr/epoch/adin/1999-12 



Circular Log Files 
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Witliin each subdirectoiy, the archived logs are written to a 
detail. rfisy file. For example, the following file contains the 
detail log for December 23, 1999. 

/usr/epoch/adm/1999-12/detail.23 

If more than one rotation occurs on a single day, another siiffbi 
is added as shown in the following examples: 

/usr/epoch/acim/1999-l2/detail.23. 0 

/•asr/epoch/adm/1999-12/detail .23.1 

/usr/epoch/adm/1999-12/detail.23.2 

The liighest number suffix (detail.2.3.2 in tliis example) 
represents the most recent log. 



Each log message provides the following information: 

• date/time string 

• host name that identifies the name of the system on which 
the event occurred 

• name that identifies the process that generated the message. 
■ optional user ID (usually .supplied if an interactive program 

is logging the message). Many subsystems can only be run 
by root and therefore omit this field. 

• process ID numter that appears between scjuare brackets. 
(Kernel messages, which are identified by the prefix 
vmunix, do not have this field.) 

• optional layer name, sometimes prefixed by a subsystem 
name, that provides EMC customer seivice with additional 
information 

• message number that uniquely identifies the message. 
Using the prefix tliat immediately precedes the pound sign 
(#). Tliis prefix is either tlie process or layer name, 
depending on the message. 
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• brief free-form description of die condition. 

To summarize, each log message conforms to tlie following 
syntax; 

date/time host process <as user> pid <<subsystera:> layer:> message # — message 
Figure 15-1 lists some sample log messages: 



Figure 15-1 Sample Log Message 

Dec 11 03:11:18 pooh backup by root [505] #456 - - Backup starting 



date/time string 



host process 



pid message # 



Jan 28 11:31:07 pooh VM as root [33] ELM:VM: #101 ■ 
dale/time string host process pjd subsysilayer message* 



Default syslog 
Configuration File 



A default, sample /etc/syslog.coni' file is provided when you 
install the sofrw'are. It contains the following lines in which the 
first column specifies the error condition and the second 
column specifies the file to which the error is logged . 



kern . err; localS . err / var/adm/epoch/concise 

kern . err; locals . err /var/adm/epoch/daily 

locals. warning /var/adm/epoch/mntf ault 

kern . info; localS . info /var/aditi/epoch/detail 
*. debug /var/adm/epoch/debug 



Note: The concise and daily logs receive the san 
messages. Tlie messages in the daily log a 
truncated each day. 
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When you run a backup or restore, EDM Backup saves infor- 
mation that you can then access through log files or reports. 
You can review this ijiformation to verify tliat your applications 
are executing correctly. 

Reports are available online in the Backup Report window of 
the EDM GUI. You can execute reports on successful, failed, 
active, and queued backups on your local EDM and on multiple 
EDMs which are set up in a domain. ITiis window enables you 
to create, modify, and print backup reports to look at key areas, 
such as performance within specified time periods, work items 
with poor performance, or failed work items. (For more infor- 
mation see the online help for the EDM Backup Report 
window.) 

Some reports are generated automatically. You can i\in the 
ebreport commands for other reports from the command line 
or insert them into your crontab file for automatic processing. 
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This cliapter describes the following reports and logs (for more 
information, refer to the appropriate man page). 



Report and Log Usage 

Executing Reports from 
the EDM^GUI 

Report and Log 
Summaries 

Backup Reports 

Backup Media Reports 

Backup Duplicate Repoits 

Backup I listoiy Reports 



Backup Disaster Reports 
Backup Baseline Reports 

Backup Completion 
Reports 

Backup Failure Reports 
Backup Coverage Repoits 
Volume Repoits 
Log Files 



Report and Log Usage You receive logs automatically, whereas you need to request 

most repoits. After a backup or restore finishes, you receive an 
e-mail message that indicates whether the operation was 
successful. (You can also monitor liackups in progress and then 
generate reports via the EDM graphical user interface (GUI); 
refer to "Executing Reports from the EI3M GUI" on page l6-3). 

If the backup or restore is successful , you do not have to review 
any of the logs and reports. However, these reports include 
information about your system that you may want to know or 
monitor. 

If your backup fails, you receive an email message that tells you 
the backup failed. You should then look at the backups.log file, 
which contains clues as to why the backup failed. If you see a 
message such as "Client not avaOable," a client may have gone 
down during the backup or your system may have a 
netVi'ork problem. You should review the backups.log file on 
the client tliat failed to see what inlormation that file has on the 
backup. 
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A MINIMAL disaster report is generated automatically each time 
the LOCAL_DATABASE work item completes. You need the 
information in this report to perform a disaster recoveiy. The 
disaster report, by default, is mailed to tlie backup adminis- 
trators, printed, and saved to disk. 

Note: Refer to Chapter 19 "Being Prepared for a System 
Disaster", 

Regardless of whether your bacloip succeeded or failed, you 
may want to review die backup coverage reports. Each report 
displays information about the filesystems that were not backed 
up. It displays the client names, the size of each filesystem, the 
name of each filesystem, and a summary line with grand totals 
for each column of information. 



Executing Reports from you can execute reports in the EDM graphical user interface 

the EDM GUI CGUI). These reports can be reports for a local EDM or domain 

reports for a group of EDMs. The online help for die Backup 
Report window explains how to set up and use a domain, and 
lists the limitations of domain reporting (for example, that a 
domain cannot span a firewall or reconcile time differences on 
machines). 

Objects in die Main window such as die EDM seiver, a client, or 
a work item, are colored to designate a successful, failed, or 
queued backup. 

^'ou can configure, run. and jirint backup reports on specific 
areas such as failed work items or work items with poor perfor- 
mance. 

Click on diis icon in the Main window toolbar to access 
the backup report module. 

For more information about active backup reporting, 
refer to EDM online help, "Backup Report Overview." 
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Report and Log You can initiate reports manually by using the following 

SUiniTiarieS commands, or you can add tliem to your crontab file for 

automatic generation. For more information on a specific report, 

refer to tlie man page for the report. 

Table 16-1 lists the reports that EDM Backup generates. 



EDM Backup Reports 



Command 



Backup 
Backup media 
Backup duplicate 
Backup liistory 

Backup disaster 

Backup baseline 

Backup completior 
Backup failure 
Backup coverage 



elireport l^ackup 
ebreport media 
ebrepon duplicate 
ebreport history 

ebreport disaster 

ebreport baseline 

none ' 
none 1 

ebreport coverage 



Contains a summaiy of die loackup activity performed 
by the sei"ver. 

Contains information al^out tlie media to wliich EDM 
Backup wrote backup data. 

Contains information about media duplication 
processes. (Refer to Chapter 9 "Media Duplication".) 

Displays information about the backups performed on 
the server. Use tlie conmiand options to display specific 
details. 

Contains a combination of other reports including a list 
of media for each backup trail, a detailed record of 
client Ijackups, copies of the key confrguration-file 
settings, and a liistorj'. 

On HSM systems, contains a summaiy of baseline 
backup activity as reflected in the saveset database. 

Confirms Ijackup operations. 

Notifies you if your backup fails. 

Displays information about which filesystems were 
backed up and wliicli filesystems EDM Backup is not 
iDacking up. 



I. There is no command available since the report is generated 
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Backup Reports 

For detailed descriptions, see the following sections in tliis 
chapter. 

Note; The examples in this chapter are from different 

ser\'ers and different configurations and limes, lltey 
cannot be compared to each other. 

Table l6-2 lists the log files that are generated by EDM Backup 
and located in /usr/epoch/EB/log on the server. For detailed 
descriptions, see "Log Files" on page 16-35. 



Table 16-2 


EDM Backup Log Files 


Report Name 


Infoirnation 


l3ackups.log file 


Displays an audit trail of backup-related activities on the seiver and 
the client. 


recoveries.log file 


Displays ebrestore operations on tlte sen'er and the client. 


ebcat.log file 


Contains catalog processing startup and shutdown times. 


Seiver log file (template level) 


Displays backup information about activities for a single backup 
schedule (template). 



BflCkUP RspOttS The ebrepoft backup command presents a summary of EDM 

Backup activity. It reports tlie status of the most recerjt backup 
run (imless the -recent or -since option is given). The work 
items are grouped by template (backup schedule) name, and 
trailset (media set). For a given work item name, the most 
recent backup is shown first. 
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Run ebreport backup eveiy day to verify that all of the 
scheduled backups completed. 



ebreport backup Command Information 



Argument Definition 



-cUent cHeiitname 



-level leoelmimber 



-since date Itrinel 
-unto date 



clientname is the client 
whose backup 1iistor>' yoi 
want to display. 



levelnumber is a level from 0 
to 9, a range of levels (for 
example, 0-8), or Bl or B2, 
for which you want to display 
backup hisioiy. 



Displays only the specified client's work 
items that are backed up to the backup 
seiver. 

When the client name used is sewernanie, it 
displays backups of seiver filesystems and 
databases, but does not display backups of 
filesystems or databases on remote clients. 

Displays only the backups of the specified 
levels (unless you use the other options to 
limit the I'eport coverage). 



date is the date in the format 
mm/dd/yy. time (optional) is 
the time in the Format 
\hb:mm\:ss]^. 



Displays all of the work items that were 
backed up by EDM Backup, from the second 
most recent level 0 backup to the present. 

Limits tlie backup report to a range of dates, 
f Jse -since to show the backups that 
occurred on or after a particular date or use - 
until to display the backup history that 
occurred on or up to a particular date. 
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Table 16-3 


ebreport backup Command Infomiation (Continued) 


Option 


Argument Definition Description 



-traUset primary | alternate Displays only the work items thai were 

backed up by a primary or alternate set of 

media (trailset). 



name is die template Selects only the backups that were created 

(schedule) from which for the named template. 

backups are selected. If "*" is 

used for name all templates 

are selected (the default). 

Note that "* " must be quoted 

on the command line 

name is the named work item Selects only the backups that were created 

for which backups were for the named work item. 

created. If "*" is used for 

name all work items are 

selected (the default). Note 

that "* " must be quoted on 

the command line. 



-template name 



-workitem name 



You might see database work items with the same name except 
for an added suffix in the fomi ": stripe_i]_of_m." This occurs 
if the backups were striped. If the backups were striped, you 
also see a suffix on the template names. For example: 

hamster :master-h : Sybase : stripe_l_of_2 . 
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Backup Reports and Log Files 


Figure 16-1 shows a sample backup report. 


Figure 16-1 


EDM Backup Backup Report 






ebfs_bt_1, Primary: ebfs_ts_1 






1 
1 

Backup Level 


1 1 

Backup States Catalog States 

Table l6-4 describes the different backup states that can appear 
in the Backup Report. 


Table 16-4 


Backup States 


State 


Description 


Started 


Backup is undei-way (or il was inteiTupted beFore finishing) 


Partial 


Backup was manually shut down before finishing 


Incomplete 


An enor caused the backup to fail 


Completed 


Backup finished successfully 


Unsuccessful 


Backup completed with errors 


Failed 


No hies were backed up, possibly due to a mlsconfigured work item 


Timed-out 


Client connection timed-out 
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Table l6-5 describes the different catalog states that can appear 
in the Backup Report. 



Table 16-5 


Status of Catalog Processing 


State Description 




Catalog is being created (or it was internipted before finishing) 


Unsoited 


Intermediate state in the post processing of the catalog. 


Sorted 


Intermediate state in the post processing of the catalog. 


Complete 


Post processing completed 


Delta 


Catalog was reduced to a colleaion of changes against the catalog of 
the subsequent backup 


Expired 


Online catalog for the backup was deleted 
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Backup Media Reports you can use the ebreport media command to display a list of 

all volumes to which EDM Backup wrote backup data. Use one 
of the options in Table 16-6 to limit tlie report size. 



Table 16-6 


ebreport media Command Information 


Option 


Description 


-active 


Displays the volumes tlial EDM Backup is currently using to write backup data. 


-offsite 


Displays the volumes that are marked for offsite storage. 


-onsite 


Displays the volumes that are marked as onsite (usually after their status was changed 
from olfsite to onsite). 


-template name 


Displays the volumes that the named template uses. 


-trailset name 


Displays the volumes that the named inedia set (trailset) uses. If -template is used, only 
"Primaiy" or "Alternate" Qjoth of v>iiich are defined in the Backup Configuration 
window), can be specified. 


-trail name 


Displays the volumes that tlie named trail uses within a trailset. 


-orphans 


Displays a list of oiphaned voluines. This cannot be combined with any other command 
line option. 


-no_baselines 


Prevents the baseline media report fi-om being generated on an EDM widi the HSM 
option. 'litis report is never displayed on a system without HSM. 


-help 


Displays command line options for ebreport media. 



A media rotation is tlie collection of volumes tliat a single 
backup schedule template writes to a paiticular trailset (media 
set) and trail during a single scheduled rotation period. 

Volumes are grouped into media rotations. The media report 
contains one secdon for each schedule template, trail, and 
trailset. Tlie report lists witliin each section the volumes for 
each media rotation witli the date, rotation ID, number of 
backups, and whether media duplication was used. 
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Backup Media Reports 

Figure l6-2 shows a sample report that ebreport media 

generates: 



Figure 16-2 EDM Backup Media Report 

Summary of all media, listed by media rotation groups 

Rotations for Template "usr_bin", 'i'rail "usr_bin_DLT", Primary' Trailset 

09/30/1998 12:54:42 Rotation 1D:4CD84987.F6BECF8D.00000200.54028F30, 4 backups 

Media duplication used on 1 copy 
*Orig Vol: 60D84A1170094B3E (Bm574), Seq #: 000024 in TLU: at_dlt 3264_0, media: DLT tape 
Dup Vol: 73D8745B3E0384A5 (BDE133), Seq #: 0CKX)28 in 'IIU: at_dlt_3264_0, media: DEF tape 
Duplication State: Done, Successful, Duplication Date 05/08/1999 16:06:04 
Descriptions 

Section Header 

Rotations for Template ^'usr^bin". Trail "usr^bin^DLT", Primary 
Shows Template Name, Trail Name, and Trailset. 

Rotation Header 

09/30/1998 12:54:42 Rotation ID:4CD84987.F6BECF8D.00()00200.54028F30, 4 backups 

Media duplication used on 1 copy 
Shows Backup Date and Time, Rotation ID, Number of Backups on Media, Use of Media Duplication. 

Volume Entries 

*Orig Vol: 60D84A1170094B3E (Bm'574), Seq #: 000024 in TLU: at_dlt3264_0, media: DLT tape 
Dup Vol: 73D8745B3E0384A5 (BDE133), Seq #: 000028 in Till: at_d]t3264_0, media: DLT tape 
Shows Asterisk for most recent volume in the rotation, Blank for ail others. 

Then Original or Duplicate, Volume ID, (Barcode), Volume Sequence Number, TLU Type, and Media Type. 
Duplication information follows with Duplicate Volume ID, (Barcode), Volume Sequence Number 
TLU Type, Media Type. 

The Duplication State, Duplication Date and Time follow. 
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Backup Duplicate Reports The ebrepon duplicate command displays a list of the original 
and duplicate volumes that are currently allocated to Epoch- 
Backup. These volumes are grouped into media rotations. 
Media rotations in the report are grouped by template, trailset, 
and trail. 

The first line in the report provides the status for the entire 
rotation; one or more lines follow that show the volumes 
allocated to the rotation. Tlie rotation status line contains the 
time that the rotation was created, the rotation ID, the number 
of partial or complete backups written to the rotation, whether 
media duplication is enabled for this rotation, and if so, how 
many duplicates were made. For each original volume the 
following duplication infonnation appears; duplication state of 
the volume (Scheduled, Done, etc.), whether the duplication is 
up to date, duplication status CEmpt>' or Old), and mode of 
duplication. 

Information for each original volume in the repoit includes the 
l6-digit volume ID, volume barcode in parentheses, volume 
sequence number, library unit in which the volume resides, and 
media type (e.g., DLT or EO). A precedes the last original 
volume that was allocated to the rotation. 

If the original volume has an allocated duplicate volume, the 
line for each duplicate volume includes the same information as 
that for the original volume. If a duplicate volume exists, the 
display may include the total tape padding blocks that were 
duplicated for tlie last duplication, duplication start and end 
limes, total duplication time, and duplicate expiration date. 

Note: Duplicate volumes that were created before this 

release of the EDM software may not display all of 
this information. 
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Duplicate Command Options Table 16-7 lists the ebreport duplicate command options and 
related information. 



Table 16-7 


ebreport duplicate Command Information 


Option 


Argument Definition 


Description 


-active 




Lists only the volumes that were last 

tlie date and time the trail was last 
written. 


-offsite 




Lists only the volumes that are marked 
for offsite storage. 


-since date 


date is the date for 
which you wisii to view 
duplication history. 


Displays only those volumes for which 
duplications were attempted on or after 
the specified date. 


-template template name 


templatename is the 
backup template for 
which you want to 
display duplication 
histoiy. 


Displays only the volumes that the given 
template uses. If this option is not 
supplied or if the given template is all 
templates appear in the report. 


trail trailname 


trailname is tlie laackup 
trail for wlricli you want 
to view duplication 
histoiy. 


Lists only the volumes tliat the given trail 
uses witliin a trailset. If tliis option is not 
supplied or if the given trail is all 
trails appear in the repoit. 


-trailset trailset name 


trailset name is the 
trailset for which you 
want to display 
duplication histoiy. 


Displays only the volumes that the given 
trailset uses. If you use -template, you 
can specify only "primary or "alternate;" 
otherwise, you can specify any valid 
trailset name. If this option is not 
supplied or if the given trailset is all 
trail sets appear in the repoit. 
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Sample Backup Duplicate 
Report 



Figure l6-3 shows a sample report using the ebreport 
dupMcate command: 



edm# ebreport duplicate 



Figure 16-3 



EDM Backup Duplicate Report 



edrn# ebreport duplicate 

Rotations for Template "usr_bln", Trail "usr_bin__DLT" , Primary Trailset 

09/15/1998 09:46:51 Rotation ID: A1D7F9BD . 71812B77 . 00000200 . F206F11B, 104 
backups 

Media duplication used on 1 copy 
Duplication State: Done, Old, Mode: New 

*Orig Vol: A1D7F9BD71812B77 (BDE098) Seq. #: 000025 in TLU: at_dlt_3264_0, 
media: DLT tape 

Dup Vol: 40D81EE7477F8BDA {BDE146) Seq. #: 000017 in TLU : at_dlt_3264_0 , media: 



Total Blocks: 349028 Start Time: 09/22/1998 10:54:26 End Time: 09/22/1998 



Duration: 001 Hrs . 31 Min., Duplicate Expiration Date: 12/17/1998 

09/30/1998 12:57:57 Rotation ID: 65D8498A. FD4DC69B. 00000200. 540819F4, 2 backups 
Media duplication used on 1 copy 



DLT tape 



13:06:21 
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Backup History Reports The ebreport history command displays reports about tlie 
backups that an EDM Backup seiver and its clients perfomi. 
The top line of each report lists the name of the EDM Backup 
server and the report creation date. Under this line, EDM 
Backup lists each backup template (schedule) that it backed up, 
and for each backup template it lists the work items that the 
template backed up. 

For each work item, the report lists the history of backups, one 
line per backup, with the most recent backups first. The line for 
each backup includes the time tliat the backup occurred, the 
backup level, the backup ID, backup status, the number of files 
or directories backed up, the backup expiration date, and 
backup recovery status. (If a backup cannot be recovered, a 
"NO" appears in the Rc\'r field of tlie histoiy report, which 
implies that catalog processing needs to be done for that 
backup.) 

If you run the command without any options, tlie history report 
can be large. You can use several options to restrict the scope of 
the report. Use the command options singly or in conjunction 
with one anotlier to select a restricted set of backups on which 
to report. The next sections describe the options to the 
ebreport history command. 
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History Command Options 


Table 16-8 lists the ebreport history command options and 
describes the information tliat is available through the 
command. 


Table 16-8 


ebreport history Command Information 


Option 


Argument Definition 


Description 


-client clierrtncime 


cHentname is ilie client 
whose backup history 
you want to display. 


Displays all of a client's work items that 
are backed up to the EDM Backup seiver. 


-workltem tvorkitemname 
or -item ivorkitemname 


ivorkitemname is the 
client's work item for 
which you want to 
display baclaip history. 


Displays a single work item's most recent 
backup history. 


-template templatename 


templatename is the 
Ijackup template foi' 
which you want to 
display baclcup hisioiy. 


Displays all of the client work items that 
were backed up bv the backup template 
(schedule). 


-since date [time] 
-imtil date 


date is the date in the 
format mm/dd/'yy. time 
(optional) is die time in 
the format lbh:mm[:ss]]. 


Limits the backup hi.story display to a 
range of dates, Use -since to show the 
backups that occuned on or after a 
particular date or use -until to display the 
backup history that occurred on or up to 
a particular date. 


-trailset primary | alternate 




Displays the work items tliat were backed 
up by a piimaiy or alternate set of media 
(trailset). 


-level leveln umber 


lewlnumber is a level 
from 0 to 9, or a range of 
levels (for example, 'o-8), 
for which you want to 
display backup histor>'. 


Displays all backups of the specified 
levels unless you use the other options to 
limit the report coverage. 


-recent 




Displays all of the work items that were 
backed up by EDM Baclaip, from the 
second most recent level 0 backup to the 
present. This report lists the standard 
ebreport history information. 
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Table 16-8 


ebreport history Command Information (Continued) 


Option 


Argument Definition Description 


-volumes or -media 


Displays the media volume names that 




are required to restore these backups. 


-recover_si2e 


Displays ilie amount of disk space that is 




required to restore each listed backup. 




Tlie size is listed in KB, MB, GB, oi' TO as 




appropriate , 


-seconds 


Displays seconds in time reported. 


-ebimport 


Displays only backups that require 




ebimport(lm) before backup can be 






-expire_times 


Displays all expii-e times (catalog, 




saveset, media), not just the one closest 




to expiration. 


-completeness 


Displays backup completeness mode tor 




each listed backup saveset. 


-dij- 


Displays the EBFS directojy ID for each 




listed ijackup saveset. 


-a or -baseline 


Includes a baseline backup repoit after 




the histoiy repoit. 


-help 


Displays command line options for 




ebreport history. 


-nopartials 


Skips backups tliat failed or are in 




progress, 


-size 


Displays the amount of data that was 




actually backed up. 




Note: Tlie backup size that this repoit 




provides may be inconsistent with tiie 




recover^' summarj' size. Ihe algorithms 




that are used to calculate recoveiy size 




and backup size are different. 
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Sample Backup History Report Figure l6-4 shows a sample report that is generated by: 
# ebreport history -recent 

for an EDM called fig that backs up two templates (schedules): 
Generic and Server. The Server Template uses both a Primary 
media set (trailset) and an Alternate. 



Figure 16-4 EDM Backup History Report 

EDM Backup History Report for server edro at Sept 30 14:19:52 1998 
Report options: -recent 

**** Work Items for Template Generic, Primary Trailset **** 
**Iteiri "vigo : /work" for client "vigo" 

Time Lvl ID Status Entries Expires Rcvr 

10/19/98 16:12 0 727 68A4B . 32F65536 coinplete 210/20/98 
10/13/98 16:04 0 72768A4B. 32F65406 complete 210/14/98 

Work Items for Template Server, Primary Trailset **** 
**Iteni "fig:/" for client "fig" 

Time Lvl ID Status Entries Expires Rcvr 

10/14/98 16:12 9 727 68A4B . 3329BF58 unsorted 405310/15/98 NO 
10/ 6/98 10:40 0 72768A4B. 331EE55C complete 525010/ 7/98 
10/12/98 23:36 0 72768A4B. 33029A9D complete 500710/17/98 



**** Work Items for Template Server, Alternate Trailset **** 
**Item. "fig:/" for client "fig" 

Time Lvl ID Status Entries Expires Rcvr 

10/19/98 0:39 9 72768A4B. 330A9265 complete 5045 10/23/98 
10/13/98 16:35 0 72768A4B. 33038955 complete 5006 10/17/98 



10/30/98 20:00 D 72768A4B. 32C9B7ED complete 432710/30/98 

All backups with complete and delta listings are available for 
restoring and appear in the EDM Restore window. 
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Backup Disaster Reports At tlie completion of every LOCAL_DATABASE backup (the 
backup of the EDM Backup database), the script 
/usr/epoch/EB/config/locaLdb_cleanup automatically 
generates a minimal disaster report. By default, tliis report is e- 
mailed to all EDM Backup administi-ators, appended to 
/'usr/'epoch/EB/config/disaster-report.log, and printed to the 
default system printer. 

The minimal disaster report provides the essential information 
you need to perform a disaster recovery on the sei-ver. It is a 
subset of the full disaster report which is generated by the 
command ebreport disaster. You should run a full disaster 
report once eveiy backup rotation and whenever significant 
system changes are made. 

Refer to Chapter 19 ""Being Prepared for a System Disaster"" for 
instructions on preparing for a disaster. See Chapter 20 "Recov- 
ering a Server from a Disk Failure" and Chapter 21 '^Recovering 
a UNrx Client from Disk Failure" for instructions on recovering 
a ser\'er and a client. 

Figure 16-5 shows selections iVom die sections of the EDM 
Backup FUI.L disaster report. It contains tlie following sections: 

• Eocal database volumes • List of installed clients 
report 

• Media report • Libraiy Manager configu- 

ration data 

• Backup liistory report • Filesystem table (/etc/vfstab) 

• Baseline backup histoiy • Locally mounted disks 
report (for HSM systems) 

• Backup coverage report • HSM local configuration 

• Backup installation report • The root crontab file 
» Backup configuration files 
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Figure 16-5 



EDM Backup FULL Disaster Report 

■ Report for server "bilbo" on Sept 



11:16:16 199S 



LOCAL_DATABASE Backup Volumes Report 



The following volunw 
which will be requii 



LOCAL DATABASE i 



Saveset ID 7271F! 



.2FAD095E for LOCAL^DATABASE backup on 9/7/98 13:54, 
■ently in library unit 



bilbo_pri_dlt #0012 (50BE6FE05346D06C) - current 

"at^dlt__32 64_0", slot #7 

bilbo^pri^DLT #0013 iEBDD020907E7982CS I dupl: 
in library unit "at_dlt_32 64^0", slot #3 



Local 
Database 
Volumes 
Report 



LOCAL_DATABASE backup will reqi 



EDM Backup Media Report for server bilbo on Sept 8 11:16:: 
Suittmary of all media, listed by media rotation groups 



Media 
Report 



for Template "bilbo", Trail "bilbo_pri_dlt", Primary Trailset 

ID:E1BE6F9E.22C1253E. 00000200. A804A0B9, 88 backups, 



08/24/98 14:06 Rot. 
Media duplication not used 
*Vol ID: 50BE6FE05346D06C, med. 
Vol ID: E1BE6F9E22C1253E, medi. 



DLT tape, number 0012 
DLT tape, number 0011 



Rotat: 



: Templati 



argo) 



alt dlt' 



Alt( 



ilsf 



08/22/98 20:03 Rotation ID: 34BE6662 . C1CEE018 . 000002 DO . 48080A35, 1 backup. 
Media duplication not used 

*Vol ID: 34BE6662C1CEE018, media: DLT tape, number 0009 
Vol ID: E1BE6F9E22C1253E, media: DLT tape, number 0011 



Rotations for Tempi; 
08/22/98 20:03 Rotai 
Media duplication not used 

*Vol ID: 34BE6662C1CEE018, media: DLT tape, n- 



argon". Trail "argon_alt_dlt", Alternate Trailset 
ID:34BE6662.C1CEE018. 00000200. 48080A35, 1 backup. 



EDM Software Reference 



16-21 



Backup Disaster Reports 



EDM Backup Hi: 
Report option; 



Cory Report for 



: March 8 11:16:21 1998 



Lvl IDSti 



Entj 



9/ 7/98 17:58 0 7271F980 .2FAD0B70 comple 
BDBE8F4 8.D50C5B38. 002 3CDOO. F40D4A0A 

9/ 6/98 17:58 9 7271F980 . 2FABB9E6 delta 
BDBE8F4B.D50C5B38.0022D4 00. 610AF0E0 

9/ 5/98 17:58 9 7271F980 . 2FAA685E delta 
BDBE8F48.D50C5B38. 0021COOO.B20A1983 

9/ 4/98 17:58 9 7271F980 . 2FA91 6DA delta 
BDBE8F4 8.D50C5B38. 0020B300.FFOC66BE 

9/ 3/98 17:58 8 7271F980 . 2FA7C582 delta 
BDBE8F48.D50C5B38. 001F4E00. FC0D0D5F 



serverdb Compl« 
e33075 9/12/9! 



1006 9/e/98norinal file: 



Items for Templai 



*Itei 



cli. 



"chef 



Time Lvl ID Status Ent 

Directory ID 

9/22/98 20:02 0 727 1F980 . 2F999998 complet( 
34BE6662. CICEEO 18. 00000500. 4B0EB4 53 



es Expires serverdb Complete 
32434 9/24/98 normal file, 



EDM Backup Baselii 
Report options: n( 



:kup Hi; 



' Reporl 



**** Baseline Backups for Template Serve] 
**Item "fig: /catalogs" 

Time Lvl ID Stai 

9/ 5/98 10:23 Bl 72768A4B . 32 FBA612 pari 



, Sept 27 14:43:49 : 



Baseline Backup 
History Report 
(for HSIM 
systems) 



Time Lvl ID Sta^ 

9/ 5/98 17:41 Bl 72768A4B . 32F90C9A no ( 

9/ 5/98 10:23 Bl 72768A4B . 32 F8A611 no ( 

9/ 4/98 19:56 Bl 72768A4B . 32 F7DADA par- 
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EDM Backup Coverage Report for server adam at Sept 8 11:16:23 1998 
Report options: none 

Filesystems currently backed up : Cur rentMaxCurrentMax 

adam:/ 4381/41536 files, 50. 3 MB/ 74.9 MB adam:/datal 27/ 63152 files, 3. 4 MB/ 250.0 
MB adam:/data2 21/ 63152 files, 3.3 MB/250.0 MB 

hamster:/ 17854/215040 files, 600.1 MB/ 778.2 MB negril:/ 3685/ 98176 files, 64.1 
MB/ 187.9 MB negril : /data 5/ 191872 files, 1.3 MB/ 750.8 MB 

Total: 17 filesystems backed up 62480/ 2202176 files, 1.4 GB/ 6.9 GB 

EDM Backup Installation Report for server adam at Sept 27 14:23:26 1998 
Report options: -all 

Installation 

EDM Backup currently running load 6.0.0.0 Report 



Coverage 
Report 



/usr/epoch IS A SYMLIMK to /ep_usr/epoch 
/usr/epoch/EB is a real directory under /ep__usr /epoch 
/usr/epoch/GENDIR IS A SYMLINK to /home/epoch 

/usr/epoch/EB/adaiii is a real directory under /usr/epoch/EB 
/usr/epoch/EB/bin is a real directory under /usr/epoch/EB 
/usr/epoch/EB/catalogs IS h SYMLINK to /home/epoch/EB/catalogs 

The local client is of the type: sun_sun4_v55 srv 

The client backup username is: ebadmin 

The user ID for ebadmin is: 24375 

The group ID for ebadmin is: 25 

The home directory for ebadmin is: /usr/epoch/EB 

Client negril is of type sun_sun4_v55_emc (5.0.0.0) installed 1998 Sept 13 16:06:21 
Client adam is of type sun_sun4^v55^srv {5.0.0.0) installed 1998 Sept 27 13:24:46 
Client hamster is of type hp__700^v9 (5.0.0.0) installed 1998 Sept 27 13:55:29 

End of EDM Backup Installation Report for server adam at Sept 27 14:23:26 1997 
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Displaying current EDM Backup configu 
Sept 8 11:16 1998 /tmp/eb.cfg Page 1 
ebserver: "bilbo" 



client backup 
backup admini 



Backup 

Configuration 

Files 



"ebadmin' 



authorized backup li; 
"bilbo" ', 



perforin initial full backup as : 
} /* end startup parameters */ 



iClients Installed File 



# Format : I, len, host, timestamp, len, method, 



, platform, RMS, vlength , ve rsio) 



7, wildcat, 837787183, 7, edinlink, 0, 99, 0, 7,5.0.0.0,; 
4, fish, 842992815, 7, netware, 10, 113, 0, 7,5.0.0.0,; 

6, berlin, 850748622, 7 , netware , 10 , 53 , 0, 7,5.0.0.0,; 

7, warthog, 850776740, 7, netware, 0 , 113, 0 , 7,5.0.0.0,; 
4, zero, B50777296, 7 , netware, 0 , 11 4, 0 , 7,5.0.0.0,; 

7, hamster, 851018343, 3, rsh , 0, 75, 0, 7,5.0.0.0,; 

6, jumper, 856192150, 7 , edmlink, 0 , 107, 0, 7,5.0.0.0,; 
4, Vigo, 856385813, 7, edmlink, 0, 109 , 1 , 7,5.0.0.0,; 

8, chipmunk, 857155162, 3 , rsh, 1 , 97 , 0, 7,6.0.0.0,; 

6, negril, 858032953, 7 , edmlink, 0 , 1 09, 1 , 7,6.0.0.0,; 

2, Indianapolis, 858725141, 7, netware, 1, 53, 0, 7,6.0.0.0,; 

3, fig, 859312730, 6, direct, 0, 108, 1, 7,6.0.0.0,; 

6, bolton, 859571785, 7, edmlink, 0, 93,0, 7,6.0.0.0,; 

7, pilgrim, 859821588, 7, edmlink, 0, 99, 0, 7,6.0.0.0,; 
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Library 
Manager 





L-a_name 


Name 


ID 






L 


offline_0 








synced 


L 


off site_^0 










L 


at„dlt_32 64_0 




(0, 


1, 1,0) 


synced 


D 


at_dlt_32 64_0 


drive^O 


(0, 


1, 5, 0) 


enabled 


D 


at__dlt___32 64_0 


drive^l 


(0, 


1, 4,0) 


enabled 


D 


at__dlt^32 64_0 


drive___2 


(0, 


1,3,0) 


enabled 


L 


hp_mf_^cl7xx_0 




(0, 


.2, 6,0) 


synced 


D 




drive^O 


(0, 


.2,5,0) 


enabled 


D 


hp_mf_cl7xx_0 


drive^l 


(0, 


2,4,0) 






hp_inf_cl7xx_0 


drive_2 


(0, 


.2,2,0) 


enabled 


D 


hp_mf_cl7xx_0 


drive___3 


(0, 


.2,1,0) 


enabled 



Sept 21 10:51 1998 /etc/vfs- 



Filesystem 

Table 

/etc/vfstab 



#/dev/ds}c/cldOs2 /de\ 
fd - /dev/fd fd 

/proc - /proc pre 
/dev/dsk/cOtSdOsl - - 
/dev/dsk/c0t3d0s0 
/dev/ds]c/c0t3dOs6 
/dev/dsk/c0t2d0s3 
/dev/dsk/c0t3d0s5 
/dev/dsk/c0t2d0s0 
/dev/dsk/c0t2d0sl 
/dev/dsk/c0t3d0s7 
swap - /trap tmj 



/rdsk/cld0s2 /usr ufs 



/dev/rdsk/c0t3d0s0 
/dev/rdsk/c0t3d0s6 
/dev/rdsk/c0t2d0s3 
/dev/rdsk/c0t3d0s5 
/dev/rdsk/c0t2d0s0 
/dev/rdsk/c0t2d0sl 
/dev/rdsk/c0t3d0s7 



/datal vxfs 
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Displaying locally mounted disks... 

/ {/dev/dsk/c0t3d0s0 }: 8192 block size 1024 frag size 

153534 total blocks 50292 free blocks 34952 available 41536 total files 

37126 free files 8388632 filesys id Locally 

ufs fstype 0x00000004 flag 255 filename length Dlsks*^'' 

/usr {/dev/dsk/c0t3d0s6 |: 8192 block size 1024 frag size 

769694 total blocks 432834 free blocks 355874 available 192576 total files 
177771 free files 8388638 filesys id 

ufs fstype 0x00000004 flag 255 filename length 

/home {/dev/dsk/c0t3d0s5 ): 8192 block size 1024 frag size 

495936 total blocks 176534 free blocks 150656 available 23840 total files 
21507 free files 8388637 filesys id 

vxfs fstype 0x00000004 flag 255 filename length 

EpochMigration Local Configuration HSM Local 



Epochttigration System Configuration: 

Enable_stage_out Max___trails Enable_self _describin( 



Staging trail "PubsTra il_l " 

Stage outs enabled: Y Media: EO Dnrestricted 

Self-Describing enabled: N 

Enable HWM LWM PSWM Delay Mntpoint 

y 95 88 80 0 defaults for PubsTrail_l 

Y 95 88 80 0 /home 



EpochMigration Current Migration Volumes 
Current primary staging volumes are: 

Staging trail "PubsTrail_l" 

Sequence: 14 Mside: 1 Volid: 11CC39F59912E6A9 Nblocksavail : 314529 
Staging trail "PubsTrail_2" 

Sequence: 13 Mside: 1 Volid: 89CC2F69030965E2 Hblocksavail: 314529 



Configuration 
(HSM Is options 
with EDM) 
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Displaying root crontab... 

tident"e(#!rootl. 1193/04/08 SMI"/* SVr4.0 1.1.3.1*/ 

1 „, rootcro 

# The root crontab should be used to perform accounting data collection. 

0 2* * 0,4 /etc/cron.d/logchecker 

5 4**6 /usr/lib/newsyslog 

15 3 * * * /usr/lib/fs/nfs/nfsfind 

# Invoke EDM Backup backup program lEPCebs 

45 13 * * * /usr/epoch/EB/bin/ebbackup bilbo >/dev/riUll 2>&1 lEPCebs 

# Invoke EDM Backup backup program #EPCebs 

00 14 * * * /usr/epoch/EB/bin/ebbackup argon >/dev/null 2>S,1 #EPCebs 

t Invoke EDM Backup backup program #EPCebs 

15 14 * * * /usr/epoch/EB/bin/ebbackup lucifer >/dev/null 2>&1 lEPCebs 

# Invoke EDM Backup catalog expiration program #EPCebs 

30 00 * * * /usr/epoch/EB/bin/ebexpire -expire -purge >/dev/mill 2>&1 #EPCebs 
t Invoke EDM Backup catalog cleanup program fEPCebs 

00 1 * * * /usr/epoch/EB/bin/ebcatclean -fix_saveset >/dev/null 2>&1 fEPCebs 

# Invoke EDM Backup LOCAL^DATaBASE validity check program lEPCebs 

00 3 * * * /usr/epoch/EB/config/local_db^warning >/dev/null 2>&1 lEPCebs 

#40 * * * * /usr/epoch/lib/epnewlog 500000 > /dev/null 2>&l#EPCgl 

#00 23 * * 6 /usr/epoch/lib/epnewlog > /dev/null 2>&l#EPCgl 

#00 07 * * * /usr/epoch/lib/eptrunclog root > /dev/null 2>&l#EPCgl 

#30 08 * * * /usr/epoch/lib/epcleanup > /dev/null 2>6,l#EPCgl 

40 * * * * /usr/epoch/lib/epnewlog 500000 > /dev/null 2>il#EPCgl 

00 23 * * 6 /usr/epoch/lib/epnewlog > /dev/null 2>&l#EPCgl 

00 07 * * * /usr/epoch/lib/eptrunclog root > /dev/null 2>Sl#EPCgl 

30 08 * * * /usr/epoch/lib/epcleanup > /dev/null 2>&l#EPCgl 

#50 8 * * * /usr/epoch/lib/ebfs/ebf s_cleanup > /dev/null 2>sl#EPCebfs 

50 8 * * * /usr/epoch/lib/ebfs/ebfs_^cleanup > /dev/null 2>&l#EPCebfs 



End of EDM Backup FULL Disaster Report for server "bilbo" on Sept 8 11:16:16 1998 



End of EDM Backup Disaster Report 
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Backup Baseline Reports In HSM systems, ebreport baseline generates the baseline 

report wliich presents a summary of backup baseline activity as 
reflected in the saveset database. A status line is printed for 
every non-expired baseline backup of eveiy work item selected 
by the arguments. 



ebreport baseline Command Information 



Argument Definition 



-client client name 



-item workttemname 



-template templatename 



-since date \Ume] 
-imtii date 



cUentname is tlie client 
vvliose baseline history you 
want to display. 

workitemname is the client's 
work item for wliich you wan 
to display baseline history. 



templatename is the backup 
template for wliich you want 
to see a baseline suminan'. 



date is the date iji the formal 
mm/dd/yy. time (optional) if 
the time in the format 
mmmV.ssM 



Displays only backups that were 
created for the named client. 



Displays only bacloips that were 
created for tiie named work item. If 
the name "*" is used, all work items 
are selected. Note that "'" must be 
quoted on the command line. 

Displays only backups that were ran 
from the named template (schedule). 
If the name is used, all work items 
are selected. Note that must be 
quoted on the command line. 

Also displays the backup 
completeness mode for each reported 
work item backup. 

Lists only baseline backups since the 
second most recent level 0 backup for 
each work item. 

Limits the backup display to a range of 
dates. Use -since to show the backups 
that occuned on or after a particular 
date or use -until to display the 
backup that occurred on or up to a 
particular date. 
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Table 16-9 



ebreport baseline Command Information (Continued) 



Option 



Argument Definition 



-trailset primary | alternate 
-level[Bl|B2] 



Displays tlie work items that were 
backed up by a primary or alternate 
trailset. 



Displays only savesets for backups of 
the given level. You can enter up to 
two -level options in a single 
invocation, each occurrence adding 
another level to the selection set. 



Figure 16-6 shows a sample baseline report generated 
by ebreport baseline. 



EDM Software Reference 



16-29 



Backup Completion Reports 



Figure 16-6 EDM Backup Baseline Report 

EDM Backup Baseline History Report for server tesla at 
Sept 17 09:37:43 1998 
Report options: none 

Teni|)late 

*** Baseline Backups for Template bline_bt_l, Primary Trailset *** 
**Item "bline_wi_l" 

Time Lvl ID Status 

9/16/98 18:00 Bl 55412298 . 2FB92071 no cat 



Baseline Backups for Template default, Primary Trailset ** 



Time 



'tesla: /dataS" 
Lvl ID 



9/16/98 


18 


00 


9/15/98 


18 


00 


9/14/98 


18 


00 


9/13/98 


18 


00 


9/12/98 


18 


DO 



Status 
55412298 .2FB9206C j 
55412298. 2FB7CEFA i 
55412298. 2FB67D77 i 
55412298. 2FB52BF5 i 
55412298. 2FB3DA6C i 



> cat 
I cat 
' cat 
I cat 

> cat 



Backup Completion EDM Backup prepares backup completion reports and can send 

Reports tliem to specified individual(s) via a sliell script. (For setup 

details see "Backup Completion Script" on page B-79.) 

Figure 16-7 shows a sample backup completion report. 
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Figure 16-7 EDM Backup Completion Report 

Date, Time and 9/05/98 18:31:21 [ 2295 : /usr/epoch/EB/bin/ebbackup] 
Process ID #, Summary report for processing template "mwf" 
Template 

Date, Time and 9/05/ gg i8:3i:21 [ 2295 : /usr/epoch/EB/bin/ebbackup] 

process ID #, processing of work item "cadl-all" via template "default" Level 0 

Work Item, SUCCEEDED 

Template, trailset was "cdr", trail was "cdr tape", 59 files backed up in 
Trailset, Trail, 886KB 

Number of Files9/o5/98 18:31:21 [ 2295 : /usr/epoch/EB/bin/ebbackup] 

Backed up and pj.o(,ggsj_ng ^^j-j, ^^g^ "cad2-all" via template "default" 

Number of kb SUCCEEDED 

Used trailset was "cdr", trail was "cdr tape", 312 files backed up 

in 55809KB 

9/05/98 18:31:21 [ 22 95 : /usr/epoch/EB/bin/ebbackup] 
processing of work item "cad3-all" via template "default" 
SUCCEEDED 

trailset was "cdr", trail was "cdr tape", 10257 files backed up 
in 135514KB 

9/05/98 18:31:21 [ 22 95 : /usr/epoch/EB/bin/ebbackup] 
processing of work item "cad4-all" via template "default" 
SDCCEEDED 

trailset was "cdr", trail was "cdr tape", 25306 files backed up 
in 203749KB 



The seiver eb_server_config installation procedure creates the 
mailuk script to which it passes the backup completion infor- 
mation. Tlie script mails a completion statement to individuals 
responsible for backup operations, and/or writes tliem to a log. 

Because die ebbackup program mails these reports immedi- 
ately after a backup, you can read them as soon as tlie backup 
completes. 



EDM Software Reference 



16-31 



Badup Failure Reports 



Backup Failure Reports whenever EDM Backup encounters an error that prevents 

backup completion (for example, a client system has crashed), 
it generates a backup failure report. (For setup details see 
"Backup Failure Script" on page B-80.) 

The EDM Backup program can send backup failure reports to 
specified individuals via a shell script. Because EDjM Backup 
mails these reports whenever a failure occurs, you are notified 
of a failure as soon as it happens. On the other hand, if you 
don't receive one of these reports, you can assume your 
backups are successful. When you receive a backup failure 
report, you should fix the problem with die client system. 
However, EDM Backup continues to back up all other clients in 
the backup template (schedule), skipping those tliat had a 
problem. 

Figure 16-8 shows a sample backup failure report. 



Figure 16-8 EDM Backup Failure Report 

Date, Time, 9/06/98 06:22:21 [ 3423 : ebbackupd errno=35{ Operation would 

Process ID #, Error block}, ec=0xl9] Workitem "docl-all" backup TIMED-OUT 
Number, Work Item 
Name, and Reason 
for Failure 



The server eb_server_config installation procedure creates the 
mailerr script to which it passes the backup failure infor- 
mation. The script mails a failure statement to individuals who 
are responsible for backup operations, and/ or writes them to a 
log. 
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Backup Coverage Reports The cbrepon coverage command makes it easy for you to 

detennine if new filesystems were added to client systems and 
if tliey are getting backed up. When tlie report lists a filesystem 
that EDM Backup is not cun-ently backing up, and the 
filesystem is one lliat you want to backup, you'll need to edit 
the client's work item statement to add the filesystem to the list 
of backup files. 

Note: ebreport coverage reports on Unix and Windows 
NT filesystems only (no NetWare filesystems). 

You can use the ebreport coverage command to display 
backed up and non-backed up filesystems on EDM Backup 
clients. The ebreport coverage command displays the backup 
status of all filesystems or you can use the options to display the 
following information. 



Table 16-10 ebreport coverage Command Information 



Command 


Argument Definition 


Description 


-client cUenttmme 


clientnaine is the client whose 
backup histoiy you want to 
display. 


Displays a single client's backed up and 
non-backed up filesystems. 


-completeness 




Sliows what kind of data is being backed 
up (for resident files only). 


templatename 


templatename is the backup 
template (schedule) for which 
you want to display backup 
history. 


Displays a backup template's non-backed 
up filesystems; with the templatename 
option displays the backup status of the 
specified template(s') filesystems. 


-installed 




Sliows installed EDM Backup clients - 
displays aU backed up and non-backed up 
filesystems in installed client list. 
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Figure 16-9 shows a report generated by ebfeport coverage 

for three clients (adam, liamster, and negril), and identifies the 
fields in the report. 



Figure 16-9 EDM Backup Coverage Report 

EDM Backup Coverage Report for server adam at Sept 8 11:16:23 1998 
Report options: none 



Fllesystems currently backed up: Current Max Current Max 

adam:/ 4381/ 41536 files, 50.3 MB/ 74.9 MB 

adam:/datal 27/ 63152 files, 3.4 MB/ 250.0 MB 

adain:/data2 21/ 63152 files, 3.3 MB/ 250.0 MB 

hamster:/ 17854/ 215040 files, 600.1 MB/ 778.2 MB 

negril:/ 3685/ 98176 files, 64.1 MB/ 187.9 MB 

riegril:/data 5/ 191872 files, 1.3 MB/ 750.8 MB 

negril: /datal 4/ 191872 files, 1.3 MB/ 750.8 MB 



:ms backed up 62 480/ 



2202176 file: 



VolUinS Reports The dbreport reportname command generates reports from 

the system administration database. 

Note: Ordinarily, only privileged users (those running as 
root) can am dbreport. 
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Some of these repoits are listed in Table 16-11, to see a full list 
of reports see the dbreport man page. 

dbreport Command Information 



Report Name Description 



Generates a i-epojt of all the volumes known to the system. 

The fields of the report desaibe the type of media, the name of the application that 
cuixently owns tire volume, the name assigned to the volume, the sequence number of the 
volume, the side of the volume, and the barcode of the volume, if any. 

Generates a report of just those v'olumes that are cun-ently available foi' allocation. 

Generates a report of application volume usage s 



available 
appl_usage 



The fields of the report are the application name, the volume name, the media t^'pe, the 
sequence number, the side, barcode, the number of blocks available, used, and stale in 1 
KB units, the percentage of the volume which is stale data, and the number of files used 
and stale on die volume. 

Generates a report of all media in system library units. 

The report is sorted by application, media t\^pe and application-dependent name. 

Generates a repojt of all media not in any system library unit. 

'I'he report is sorted by application, media type and application-dependent name, 

Generates a report of all media wliich has been moved to offsite storage. 

The volumes in this category can be re-introduced to the system by being injected into a 

The report is sorted by application, media type and application-dependent name. 
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dbreport Command Information (Continued) 



Report Name Description 



Generates a report of staging volume usage statistics. 

I'he fields of the report are the volume name, sequence number, side, barcode, tlie 
number of blocks used and stale in 1KB units, the percentage of the volume which is stale 
data, and the number of files used and stale on the volume. 

Generates a report of baseline volume usage statistics. 

The fields of the report are the volume name, sequence number, side, barcode, the 
number of blocks used and stale in 1KB units, the percentage of the volume which is stale 
data, and the number of files used and stale on the volume, 



Generates a repoit you can us( 
which HSM volumes to compact w 



the staleness of volumes 
the emcompact utility. 



Log Files You can access backup log files directly and monitor them or 

review them for troubleshooting. For example, use tail -f to 
monitor progress during processing and use vi or other editor 
to review logs at a later time. 

When filled, the oldest ten percent of these files is deleted on 
an ongoing basis. 



Server Log Files EDM Backup automatically creates log files in the directory 

/'usr/epoch/EB/log on the EDM Backup server. 
• The backups.log file contains information about backup 
operations. EDM Backup adds information to this file each 
time it backs up a template's work items. Selected notifica- 
tions that appear in this log file also appear in otlier backup 
reports. It accumulates detailed shutdown and startup infor- 
mation each time a database work item is backed up. 
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Every rwo minutes ebbackup reports the average rate in 
KB/s for ALL work items being backed up. 'Hiis rate is 
affected by process timing, data buffering, and overhead in 
ebbackup. If you want to see the rate for a specific tape 
drive, see the EDM Libraiy Unit Manager window wliich 
reports on an active drive every thirty seconds. 
The recoveries.log file contains file restore startup and 
completion notifications. Use these files for comprehensive 
information about backup and restore activities on your 
EDM server. 

The efc)cat.log contains startup and shutdown times for 
catalog processing and output from ebexpire and 
ebtaiport. 

The 1emplate_iiame. log records backup information for a 
single template. 

"^Tienever you want to see the backup histoiy of a single 
backup template (schedule), use the template_name. log 
file, llie information in tliis log file varies depending on the 
logging leuel you specified in the configuration database 
(see "Server Log File" on page B-78). Thus, you can use the 
file to view a history of backup-related events for a single 
template. 

The default log file is located in 

/'usr/epoch/EB/log/default_template.log. 

The default logging level, stats, reports when each client 

backup or restore begins, and includes periodic progress 

indications. 

There are five logging levels. Use the debug and per file 
levels to diagnose problems only when instructed by 
customer sen'ice. 
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Local Client Ioq Files 



Remote Client Log Files 



Other Logs 



EDM Backup automatically creates two log files on tlie EDM 
Backup client: the backups.log and recoveries.log in the 
directory /usr/epoch/EB/CLlENT_HOME/c//eK/. 'Hie 
backups.log file contains an audit trail of backup-related activ- 
ities listed in clironological order. The recoveries.log file 
contains an audit trail of restore-related activities listed in 
chronological order. 

• backups.log accumulates detailed scanning information 
each time a local work item is backed up. 

• recoveries.log records general start and end notifications for 
restore processing each time a local work item is restored. 



On the remote clients, backups.log and recoveries.log files 
reside in the directory 

/usr/epoch/EB/CLIENT_HOME/c//CTfHfl/??e. Tliey record 
network backups and restore operations. 



Other logs record volume management and othei- system 
activit)': 

• System logs are located in /var/adm 

• System logs are archived in Aisr/epoch/adm 

• Circular logs are located in /usr/epocVadm/circular 
System logging is configurable in /etc/syslog.conf. 
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Part IV 

Command Line 
Intertaces 



^ Configuring 
I g Library 

Managers 



When you change EDM configuration by adding or removing a 
libraiy unit, you need to reconfigure the software to recognize 
the change. 

This chapter describes the sciipt diat you use to install device 
drivers and configure Libraiy Managers for library units that are 
connected to llie EDM. 

Tlie chapter describes the following tasks: 

• Using the Imconfig Utility 

• listing Libraiy Managers 

• histalling Device Drivers 

• Updating Device Drivers 

• Removing Device Drivers 

• Configuring a Library Manager 

• Deconflguring a Library Manager 
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Using the ImCOnfig Utility The Imconfig utility, enables you to: 

• list currently configured Library Managers 

• install, update, and remove device drivers 

• configure and deconfigure library Managers 

• access a help option that briefly describes the main menu 
entries 

(Refer to the Imconfig man page for more information about 
this utility.) 

Note: Imconfig is located in /usr/epoch/bin. Make sure 
that this pathname is defined in your PATH 
environment variable. 

To start the configuration script, log in as root and enter the 
following command to display the main menu, hi this menu, 
you select the configuration you want to perform. 
# Imconfig 



EMC LIBRARY MANAGER CONFIGURATION TOOL 
Main Menu 

1 LIST current Library Manager configurations 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 AUTOCONFIG Automatically configure all library unit 

6 DECONFIGURE a Library Manager 

7 HELP 

Choose the configuration operation you want (1, 2, 3, 4, 5, 6, 7, q 
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Listing Library Managers when you choose 1 LIST from the main menu, Libraiy Managers 
that are currently configured in / usr/'epoch/etc/lm appear. 
Imconftg lists the name of tlie Library Manager and tlie device's 
SCSI address for the robot and each drive, as shown in the 
following example: 

Imconfig completed configurations: 

offline^O 
of fsite__0 

rO: 0 2 2 0 

dO: 0 2 3 0 

dl: 0 2 4 0 

d2: 0 2 5 0 



library Manager Name The Library Managers name identifies the manufacturer, drive 

type, and model number of the device. 

Note: In releases previous to EDM 4.5.0, the Library? 

Manager name includes the drive type (DLT, DTP, 
HITC, etc.); for example, "at_dlt„452_0." 

For example, die Library Manager name, at_452_0, has the 
following meaning: 



Manufacturer of the automated tape library 
unit: ATL Products. 

Manufacture]"'s model number; in this 
example, tlie ACL 4/52 automated tape library 
unit. (4 drives/52 slots) 

Indicates the first Library' Manager that is 
configured for this libraiy unit type. Tlie suffix 
increments for each additional library' unit of 
this type that you configure. 
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SCSI Address The SCSl address includes the system board number, SCSI bus, 

SCSI target ID, and logical unit number (lUN) of the libraiy unit 
robot and drive(s); for example: 

rO: 0 2 2 0 
dO: 0 2 3 0 

System Board # 1 I 

SCSI Bus 1 

SCSI Target ID ' 

LUN 

In this example, the libraiy unit's robot and drive are on system 
board 0, SCSI bus 0; the robot's SCSI target ID is 0, and its LUN 
is 0. Ilie libraiy unit has one internal drive at SCSI target ID ], 

LUN 0. 



Installing Device Drivers when you choose 2 INSTALL from the main menu, Imconfig 

installs the device drivers into tlie /devices directory. You must 
install device drivers before you configui-e a Libraiy Manager. 
This option requires that at least one library unit be connected 
to die sei-ver and operational. 

To install device drivers, use the following procedure. 
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1 . Choose 2 INSTALL from the main menu. A prompt asks you 
to confirm the installation: 



Main Menu 

1 LIST current Library Manager configurations 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 AOTOCONFIG Automatically configure all library units 

6 DECONFIGURE a Library Manager 

7 HELP 

Choose the configuration operation you want {1, 2, 3, 4, 5, 6, 7, q)? 2 
About to install all EMC drivers. 
Do you wish to continue {y,n)? y 



2. Enter y to begin driver installation. (Note that driver names 
vary by platform.) Tlie script displays several messages tliat 
confirm driver installation. 

Modifying kernel driver. conf files 
Modifying /kernel /drv/st . conf 

Installing drivers 
Installing driver mo 
Driver mo installed 
Installing driver sjb 
Driver sjb installed 

Note: Ignore messages that indicate failure of mo driver 
installation. 

3. After the drivers are installed, shut down the system to the 
PROM level by entering the following command: 

# shutdovm -y -i6 -gO 

This command enables a reconfiguration reboot of the 
server. 

4. After EDM shuts down and reboots, log in as root and 
restart Imconfig. 
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The main menu appears, as shown: 

EMC LIBRARY IttNAGER CONFIGURATION TOOL 
Main Menu 

1 LIST current Library Manager configurations 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 AUTOCONFIG Automatically configure all library uni 

6 DECONFIGURE a Library Manager 

7 HELP 

Choose the configuration operation you want {1,2,3,4,5,6,7, 



EDM probes the bus for all attached hardware and assigns 
device nodes in tlie filesystem that represent the devices 
that are found. It also configures the logical namespace in 
/dev and the physical namespace in /devices. 
5. Select 5 AUTOCONFIG to configure Libraiy Managers 
automatically for the attached library units. Refer to 
"Configuring a Librar}- Manager" on page 17-8 for this 
procedure. 



Updating Device Drivers choose 3 update from the Imconlig menu to reinstall device 
drivers. You must update the device drivers after updating the 
EDM software or updating the module tliat contains the drivers. 

When you update device drives, no Libraiy Manager 
reconfiguration is required. 

To update the device drivers: 

1. Choose 3 UPDATE from the main menu. 

2. Confirm the update at the prompt. 
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Removing Device Drivers choose a remove from the Imconlig menu to remove all 
device drivers from the /devices dii-ectoiy. You must remove 
device drivers before deinstalling die EDM software. 

To remove device drivers, select 4 REMOVE from the main 
menu. Then confirm the removal at the prompt 

Sample output appears below. 



1 LIST current Library Manaaer configurati 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 AOTOCONFIG Automatically configure all library un, 

6 DECONFIGURE a Library Manager 

7 HELP 

Choose the configuration operation you want 
(1, 2, 3, 4, 5, 6, 7, q)? 4 
About to remove all EMC drivers. 
Do you wish to continue (y,n)? y 

Modifying kernel driver. conf files 
Modifying /kernel/drv/st . conf 

Removing drivers 
Removing driver mo 
Removing driver sjb 
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Configuring a Library Use the AUTOCONFIG option of Iniconfig to configure 

Manager a Ubraiy Manager automatically for each libraiy unit that is 

attached to die EDM. 

AUTOCONFIG verifies that offline and offsite daemons are 
configured. Then it searches for all device nodes in the 
system, acquires all necessary information, and configures a 
library manager for each librar>' unit. AUTOCONFIG automati- 
cally unloads all drives and puts tlie media into empty slots. 

Because the operation is automatic, you do not have to know 
the system board numbers, SCSI bus numbers, target IDs, and 
LUN numbers for each device. 

The Imconfig utility creates a subdirectoiy in /usr/epoch /etc/1 m , 
copies a sample configuration file into the directory and 
modifies it, creates a link to the executable file, and adds the 
pathname of the new Librar)' Manager to the Volume Manager's 
configuration file. (See Appendix C "Volume Management 
Configuration Files" for more information about how the 
Volume Manager uses the vni.cfg file.) 

Note: You can also use enhanced Imconfig to run 

AUTTOCONFIG and tell il not to ask any questions. 
If it detects any drives with media in them, 
AUTOCONFIG unloads the media automatically 
without asking you, and configures all unconfigured 
library' units. You run enhanced Imconfig by using 
the command Imconftg -A. 



Preparing for Configuration Before you configure Library Managers), verify that: 

• your hardware configuration is valid 

• library units are properly cabled, powered up. and online 

• device drivers were installed successfully and EDM 
rebooted 

• all library unit drives are operational 

• at least one piece of media is loaded in each libraiy unit 
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Running ImCOnfig To start configuration, do the following: 

1 . Be sure you are logged in as root. 

2. Enter the following command to display tlie Imconfig mair 
menu: 

# Imconfig 

3. Choose 5 AUTOCONFIG fi-om the main menu and then 
confirm autoconfiguralion at the prompt. 

EMC LIBRARY MANAGER CONFIGURATION TOOL 
Main Menu 

1 LIST current Library Manager configurations 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 AUTOCONFIG Automatically configure all library un 

6 DECONFIGURE a Library Manager 

7 HELP 

Choose the configuration operation you want 
{1, 2, 3, 4, 5, 6, 7, q)? 5 



Make sure the following are all true befori 



.mg: 



1. The library units were set up, cabled correctly, powered on 
and online. 

2. Drivers have been successfully installed and the system 
rebooted. 

3. All library unit drives are operational. 

4. At least one piece of media is in each library unit. 

5 . The BCS Calypso unit that has the library unit to be conf igurec 
must not be running any backups or have any opened streams t 
the drives. 

Would you like to continue with autoconf iguration (y,n)? y 
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If All Library Units Are AUTOCONFIG looks for unconfigured devices, active libi-ary 

Configured units, and loaded drives. If all libraiy units are already 

configured, the following appears: 



Starting Autoconfig v3.0 



Determining unconfigured devices: 100% 
Searching for active library units: 100% 

_autoconfig failed: *** Error: No non-configured library units found 
autoconfig: No configuration done 
Imconfig warning: AUTOCONFIG failed 



Nothing was done because all available library units are already 
configured. 



If Media Is Found In Any Drive if AUTOCONnc detects media in a drive it automatically 

unloads the drive and places the media into an empty slot. 
(Sample output follows.) 

Select y (yes) to continue with configuration. 

Note: If a mechanical problem does not allow the media 
to be moved, AUTOCONFIG fails. If you cannot fix 
the problem, shut off the problem library unit and 
then run AUTOCONFIG again to configure the 
remaining libraiy units. 
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Determining unconfigured devices: 100% 
Searching for active library units: 100% 
Checking for loaded drives: 100% 



Found some drives loaded with media. 
Unconfigured drives must not have media in them. 

WARNING: The unload program will unload all 

unconfigured drives attached to this se 



Would you like to unload the drive (s) (y,n)? y 

Searching for loaded drives in library unit: 
Vendor' HP] Product! C1710T] Board Bus Target LUN [ 0 4 0 0] 

Found 1 drives loaded with media 
Unloading 



Moving media from dr 



The Configuration Process AUTOCONHG displays a Ust of available Mbraiy units that are 

not yet configured. At die prompt, enter "a" for ail, or a 
comma -separated list to select some but not all of the listed 
library units. 

AIJTOCONFIG now configures all or selected library units. 
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Please choose which library units to configure : 



l.Vendor[HP] PrDduct[ C1710T] :: Board Bus Target LUN [0 4 0 0] 

Please enter a comma separated list of the library 
units you vjould like to configure, or 'a' for all : a 



Getting Info on Library Unit #0 : HP : C1710T : 6.10 

The robot on library unit 1 is located at: 

=== BOARD :0 BOS: 4 TARGET : 0 LON:0 === 

Number of drives = 2 

Number of slots = 32 

Number of inlets = 1 

Media found in slot number 0 

Library unit supports drive to drive moves 

Using compatible configuration files: hp_cl7xx. attr / hp__cl7xx. 



Loading Drive 0. Please Wait 

Waiting for drive to be ready . . 

Found Drive 0 : HP : C1716T : 3336 

For your information. Drive 0 is located at : 

=== BOARD: 0 BUS: 4 TARGET : 4 LUN : 0 === 

Using compatible configuration file for the drive: eo worm.tmpJ 



Loading Drive 1. Please Wait 

Waiting for drive to be ready , . . 

Found Drive 1 : HP : C1716T : 3336 

For your information, Drive 1 is located at : 

=== BOARD: 0 BUS: 4 TARGET : 5 LUN : 0 === 

Using compatible configuration file for the drive: eo_worm.tmp] 



Configuring library unit 

Enter physical location for LU qntm_x700_0 : Bl Lab 

Enter the physical location of the libraiy unit; for example, 
"Bl Lab" as shown above. 
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Selecting the Cleaner Barcode AUTOCONFIG prompts you lo accept or decline a default 

Default barcode for cleaning cartridges: 

Would you like to accept the EDM default 
barcode of CLNXXX for tape cleaners (y,n)[Y]? y 

If you answer y (yes), the Libraiy Manager recognizes any tape 
with a barcode of CLN(()00-999) as a cleaner by default and 
does not place it in the drive during an inventoiy. 

Note: To override this default you must answer n (no). 



Viewing Log Files After all library units are configured, Imconfig notifies you that 

configuration is complete. AUTOCONFIG tlien asks if you want 
to view tiie log files. If you answer yes, information for each 
library unit appears: 

Finished configuring library unit (s) . 

Would you like to see the log files (y,n)? y 



= Library Unit Info 

= Vendor ID = HP 
= Product ID = C1710T 
= Product Rev = 6.10 



( Device name : Board/Bus/Target/LUN : Vendor ID : 
Product ID : REV ) 

Robot 0 : 0 4 0 0 : HP : C1710T : 6,10 
Drive 0 : 0 4 4 0 : HP : C1716T : 3336 
Drive 1 : 0 4 5 0 : HP : C1716T : 3336 
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Completing Imconfig After the library managers are configured, type q to exit the 

Imconfig utilit}'. 

Main Menu 

1 LIST current Library Manager configurations 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5AUT0C0NFIG Automatically configure all libraryunits 

6 DECONFIGURE a Library Manager 

7 HELP 

Choose the configuration operation you want 
(1, 2, 3, 4, 5, 6, 7, q)? q 



Reboot the EDM system by entering the foD owing: 
# shutdown -y -16 -gO 

This important step starts the vmdaemon, and ebfsd and 
vmdupd daemons. EDM software does not run until these 
daemons start. 

A full inventoiy begins after the reboot; the time period for 
completing an inventoiy depends on tlie amount of media diat 
the library unit contains. 



Deconfiguring a Library When you deconfigure a Libraiy Manager, Imconfig deletes the 
ManagSr Library Manager's subdirectory and its contents. You should 

deconfigure a Libraiy Manager when you permanently remove 

a library unit from tlie seiver. 

To deconfigure a Library Manager, do the following: 
1. Start Imconfig and choose 6 DECONFIGURE in the main 
menu. 
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2. Imconfig lists the currently installed Library? Managers; at the 
prompt, select the one you want to remove: 

Choose one or more Library Manager configurations to be removed 

1 of fline_0 

2 offsite^O 

3 at_4 52__0 

4 hp^cl7xx_0 

Enter comma-separated choice (s) on a single line (1, 2, 3, 4, q) 

3. Enter the number(s) that correspond to the Library' 
Manager(s) tliat you want to deconfigure (as shown in the 
example above). 

Note: If you inadvertently remove the offline or offsite 
Librar)' Manager, Imconfig automatically adds it 
back for you. Just choose the CONFIGURE option in 
the Imconfig main menu. 

of fsite_0 removed 
qntm_x7 00_0 removed 
hp__cl7xx_0 removed 
of f line_0 removed 



The utility removes the library Manager's subdirectory and 
its contents from /usr/epoch/etc/lm. It also deletes the 
Library Manager from the vm.cfg file and notifies the 
Volume Manager to reread the file and kill the associated 
LM daemon. 
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When the main menu appears, select q (quit) to return to 
the system prompt. 



1 LIST current Library Manager configurations 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 CONFIGURE Manually configure a library unit 

6 AUTOCONFIG Autoraatically configure all library units 

7 DECONFIGURE a Library Manager 

8 HELP 

ose the configuration operation you want (1, 2, 3, 4, 5, 6, 7, 8, q)? 
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If You Have TroUbie if a drive other than drive 0 fails while configuring a library unit, 

Configuring a Library Unit AUTOCONFIG asks whether you want to configure the LU witli 
the drives tliat AUTOCONFIG was able to find (this number is 
less than the total number of drives that the LIJ contains). 
Messages that are similar to the following appear: 

*** ERROR: Cannot find node for drive 1 

*** Drive 1 may have been loaded using a 

*** cleaning cartridge, or it may be damaged or disabl 

*** Configuration of library unit #0 has stopped. 

AUTOCONFIG could only find the first 1 drive (s) 

Would you like to configure the library unit 
with only 1 drive {s) (y,n)[N]? no 

If you enter n (no), configuration of the library unit stops: 

_autoconfig failed: *** Error: SCSI location of 
drive #1 was not found 

*** Error: Unable to configure library unit #0 

If you enter y (yes), configuration completes with the drives 
that AUTOCONFIG found. 

NOTE: There is a tape in drive 1 

Please shut down EDM server after AUTOCONFIG finishes, 
and manually remove the tape from the drive. 



If a Problem Occurs While If you want to configure more than one library unit at one time 

Configuring Multiple Library and AUTOCONFIG fails because a volume is stuck in a drive. 
Units AUTOCONFIG may have a problem while removing the volume 

from the diive. 

Turn off the libraiy unit, remove the volume from the drive, and 
check the drive cables. Tlien restart EDM and restart 
AIJTOCONI^IG. lliis enables AU'I'OCONFIG to configure the 
remaining libraiy units. 
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I Q Listing 



lliis chapter lists the man pages for backup and restore 
commands, volume management commands, media duplication 
command, and HSM commands. You can display a full 
description of each command by typing man followed by the 
command name. 

The following three categories of man pages are described: 

• Backup and Restore Man Pages 

• Volume Management Man Pages 

• f ISM Man Pages 
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Backup and Restore Man 
Pages 


This section describes backup and restore commands that can 
be run from the EDjM server. Tliese commands can be used, 
among other tilings, to initiate backups (ebbackup) and 
restores ( ebrestore and ebcrecover), start the EDM window 
(edm and edmrestore), and generate a variety' of reports 
(ebreport and ebcreport) directly from the EDM server's 
command line. 


Backup and Restore 
Commands and Daemons 


Description 


eb 


Introduces the EDM Backup product, programs, daemons, and man 
pages. 


eb_build_htab 


Updates the database of hosts known to the EDM Backup Client Instal- 
lation wizai-d. 


eb_dc_backup 


Starts an EDM Symmetrix Connect backup. 




l^estores data backed up via a direct connect backup. 


eb_deinstall client 


Deinstalls the EDM Backup client software using the command-line 
interface. 


eb_deinstall server 


13einstalls the EDM Backup server software using tlie command-line 
interface. 


eb install client 


Installs tlie ED.M Backup client software (called by the EDM Backup 
Client Installation Wizard). 


eb install server 


Configures the EDM Backup sender software (called by 
eb_server_config) . 


eb rehome client 


Updates an EDM Backup client to know that it has a different EDM 
Backup server than the one from wliich it was originally installed. 


6b_server_config 


Configures a host for use as a backup se]-\'er or deconfigures it. 


eb_sybconf_db 


Configures online Sybase database backups. 


ebbackup 


Initiates and controls client backups under EDM Backup. 
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Backup and Restore 
Commands and Daemons 


Description (Continued) 


elr^ackupd 


Peiforms a backup of a single client system under EDM Backup, 


ebcatalogd 


Supervises the post-processing of backup catalogs. 


ebcatclean 


Deletes backups, catalogs, and saveset records that expired or are 
unreferenced under EDM Backup. 


ebcatcomp 


Completes the information stored in a backup catalog file and creates 
backup catalog deltas. 


ebcatproc 


Forces the processing of a baclaip catalog. 


ebcatsort 


Sorts an EDM Backup catalog file. 


ebcp 


Copies data from one place to another on an EDM Backup server, an 
EDM Migration client, or between two such machines. 


ebcrecover 


Provides an easy way to execute the ebrestore command from an 
EfJM Backup client using the client's native conneaion method. (It 
actually calls ebrecover on the EDM, which is just a symbolic link to 
the actual restore program, ebrestore.) 


ebcreport 


Enables users to run ebreport from an EDM Backup client using the 


ebexplre 


Deletes backup data, saveset records, and backup catalogs that have 


ebf s dimp vol 


Reads a volume of backup media producing a hexadecimal listing of 
its contents an/or an extendcd-cpio stream that can be read bv 
rccxcpio to restore a directory hierarchy. 


ebimport 


imports backup media, backup catalogs, and saveset records. 


eblistend 


Listens for requests from DBMS clients for backups and restores, and 
starts them as needed. 


ebre store 


Restores backup files from backups CTeated by the EDM Backup 
system. 


ebreport 


Produces several backup reports including media, history, and disaster 
reports. (See Chapter 16 "Backup Reports and Log Files".) 
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Backup and Restore 
Commands and Daemons 



Description (Continued) 



edmcre s tor e 

edmhelp 

edmlinkq 

edmproc 

edmr emote 



edmrestore 

epcleanup 

epcoinm_util 

epnewlog 
epshoHmod 
epshowpath 
epshowprod 



Generates a tree index for a backup catalog file. (Evoked by 
ebcatalogd.) 

Starts the EMC Data Manager graphical user interface. 

Starts the EDM Restore window and displays it on the backup client. 

Starts the online Help facility for the EDM. 

Allows you to queiy the remote client via the EDM Transfer l^rotocol 
to provide version and capability' information. This lias the side-effect 
of allowing the client-ser\'er connection to be tested. 



Lists, starts up, shuts down or restarts all edm daemon pre 
edmproc performs the start up/shut down operations in the correct 
order. 



EDM seiver and displays it o 



Starts the EDM GUI on a 
specified host. 

Exeaites saved reports on currently running or completed baclcups on 
a local EDM or on an EDM Domain. If using a domain, the EDM 
Domain Master machine must be a trusted machine, because the local 
administratoi- can change passwords and mn the edmreport CLI 
without knowing the IDomain Login Credentials. 

Starts the EDM Restoi'e window on the EDM Backup sers'er. 

Removes files thai are no longer needed. Usually run from crontab. 

Command line utiiit>' for communicating with the EDM Client Commu- 
nications I3aemon, epcommd. 

Rotates, archives, or truncates system Jogs. Usually mn from crontab. 
Displays all or selected installed EDM modules. 
Displays the installation location of EDM software. 
Displays infoimation for a selected or all installed products. 
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Backup and Restore 
Commands and Daemons 



Description (Continued) 



epshowvers 

eptriHiclog 

f indxcpio 
ntexchreport 

n texchres tore 

ntsqlreport 

ntsqlrestore 

oldb_exec 
portservices 
rasd 
recxcpio 

snmpeved 

sybrecover 

sybreport: 



Displays all products and their versions available on the EDM distri- 
bution CD. 



the daily message log file and mails a copy to specified 
This is usually run from croniab. 



EDM Backup's client And and xcpio program. 

Reports on the Microsoft Exchange backups that have been made to 
an EDM server. 

Restores a Microsoft Exchange object that was backed up by the EDM 
servei-, 

Reports on Microsoft SQL Sender database backups made to die EDM 
seiver. 

Restoi-es a Microsoft SQL Ser\'er object that was backed up by the 
EDM. 

Initiates an Oracle Online backup or restore from the EDM. 

Modifies the edm_sen'ices files on the EDM, enabling, changing, and 
disabling port control settings. 

RASD (Reliability Agent Scanner daemon) monitors significant system 
events that inhibit the successful completion of EDM applications. 

Creates a directoiy hierairhy that con-esponds to the contents of an 
extended-cpio stream, such as that pj'oduced by flndxcpio and tlie 
ebrestore program. 

The SNMP subagent for Volume Management and EDM Backup. 
Recovers striped database back ups from the EDM to a Sybase sei-ver. 
Reports on Sybase backups made to the EDM seiver. 
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Volume Management Man 



Volume Management 
Commands and Daemons 



The Volume Management command line interface (CLI) enables 
you to monitor volume management activities and perform 
administrative tasks at the command line level. You can use the 
CLI in a non X windowing environment (such as dial-in-sites). 
The CLI also enable you to write shell scripts to automate 
volume management tasks. 



Description 



dbreport 
edmlm 



Generates volume reports from the volume datal3ase. 

Starts the graphical EDM Library Unit Managei- separate from tire EDM 



evmaddtempl 
evmchtempl 

evmchvol 

evmclean 

evmctl 
evmeject 

evmenable 
evmimport 

evminject: 



Ci-eates a volume template for a specified media type and application. 

Modifies a volume template for a specified media type and application. 
This can be used to increase maximum usage of a template. 

Changes the attribute settings for an existing labeled volume. This can 
be used to increase maximum usage of a volume. 

Cleans drive(s) in a named libraiy unit. Before cleaning a diive, the 
cleaning cartridge must be present in the library unit. (See 
Description.) 

Queries or sets attributes of the EDM Volume Management system or 
individual liljrary units. 

Ejects the specified volume or cleaning cartridge fi-om a library unit. 
This works only with libraiy units that have an'inlet. (See Description 
to get a volumes identifier.) 



Enables a drive or library u 
when certain enors occur, 



:. Volume management disables a drive 



Imports one or more volumes into a sen'er's volume catalog. Use this 
command when you move volumes from one ser\'er to another or to 
reconstixict a volume catalog that was destroyed. 



Inserts a volume into a library u 



L. (See Description.) 
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Description (Continued) 



evminventory 
evmlabel 



Initiates an inventory of the volumes in the named libraiy unit. 

Labels the selected volume by using a specified volume allocation 
template. Use Description -t to list the names and IDs of all defined 
templates and Description to view a template's attributes. 

1-ists all running volume management processes. 



evmmount; 



evmre j ect: 
e vromi'teiQp 1 



evmseterror 



Queues a mount request for the specified volume. 

Generally, volume management handles all mount and dismount 
requests. Therefore, this command is intended only for mounting 
foreign volumes. 

Rejects a queued recjuest for a volume. 

Removes the specified volume template from the volume management 
template datal^ase. 

Removes all knowledge of an existing volume from a server's volume 
catalog. 

Enables you to set the error and/or warning count for a drive, 
volume, or library unit. 

Provides status of volume management system, including devices 
(libraiy units and drives), volumes, media types, and system notifica- 



evmiomount 

evmvol 
evmwhere 



Display 



ributes of one or more volume templates. 



Removes a volume from a drive that was mounted by using 
evmmoimt. 

Displays attributes of one or more volumes. 

Describes the attributes that are obtained by ixinning evmvol -V. This 
is NOT a command. This man page describes the where -clause 
syntax only. 

Configures library managers and device drivers for the EDM. 
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Commands and Daemons 


Description {Continued) 


vmdaemon 


EDM volume management daemon. 

Note: This command should not be run from the CLI. 


vmdup 


Manages media duplication for specified ti'ails or volumes by turning 
on duplication For manually-duplicated trails. This is also used to 
reschedule duplication for a given volume, in case a duplication failed. 


•vmdupcf g 


Displays the current values of the duplication configuration para- 
meters, and allows the values to be changed. 


vmdupd 


Run from the command line to alter the state of the currently-nmning 
vmdupd daemon that controls the media duplication, as well as to " 
display the list of volumes cuirently scheduled for duplication. 

Only one occuixence of the vmdupd (mn without arguments) can run 
at a time. 
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This section describes the following types of migration 
commands: staging and staging configuration commands, 
network migration server commands, and user level commands. 

Most users do not need die user level commands. These are 
useful for those who set up application environments and for 
those who need to understand filesystem usage patterns. 

User level commands are marked with an asterisk (*) in the 
following table. 



HSM Commands and Daemons 


Description 


ebcheck 


Finds files that liave inconsistencies with tlieir staging IDs and fixes 
them. 


em new_volunie 


Allocates a new staging volume for a specific staging template. 


embsi * 


Stages specified files in from staging media or client stores, which 
ensures tliat they are completely resident on magnetic storage. 


emcheck * 


Checks tlie HSM client and seiver configuration to verify its 
correctness, warns you of potential problems, and conects inconsis- 
tencies. 


emchmod * 


Sets the staging control properties for a file or directoiy. Unlike 
chmod, it clears unspecified properties. 


emcompact 


Automatically compacts staging volumes. Usually run from crontab. 


emcrecover_wait * 


Waits for a set of client store bitfiles to be re.stored on an EDM with 
HSA4. It scans the set of files listed on the command line and checks 
the status of every bitfile referenced by this set. 


emcreport * 


Displays information about client store usage and identifies the 
current staging targets for each stageable filesystem. 


emdu * 


Displays the number of K13 contained in all files and directories 
specified. Using the -t option displays the amount of viitual space, 
which includes the space on the EDM if the files have a staging image; 
otherwise it is the space on the local magnetic disk. 
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HSM Commands and Daemons 



Description (Continued) 



Recursively descends the directoiy liiei-archy for each pathname in the 
pathname-list, seeking files that match a logical expi-ession. 
Supports several additional predicates over find. 



Configures HSM filesystems by assigning filesys 
templates, removing filesystems from staging tei 
filesysteni parameters. 

Deconfigures a migration filesysteni. 



;ms to staging 
iplates, and changing 



emlsconf 
ems check 



ischs 
isconf ig 



isd 



emsdef s 
emshalt 



Produces virtual filesystem statistics. It displays the amount of 
stageable filesystem data, and the amount of data that is currently 
staged. It displays your working set in days of usage. 

Lists file attributes. Similar to Is, but lists staging attributes, including 
the number of KB on magnetic disk, the number of KB currently 
staged out, and seiver and client store if any, to which the file is 
staged, as well as the staging control properties, such as residence 
piioiity. 

Displays the cun-ent staging configuration pai 



Checks the network migration seivei- configuration files. The 
emscheck command checks all global and store specific files for 
syntactic and semantic coixectness. In addition, it performs certain 
clean up operations on client stores. Run emscheck nightly via cron. 

Changes certain configuration parameters for an existing store. 

Changes the protocol interface parameters. Only use at the direction 
of your customer service organization. 

The nett^'ork migration seiver daemon. The emsstart command 
always invokes tliis daemon during system stamip. The daemon 
handles all network client HSM protocol requests from the client 
systems. 

Changes certain default store configuration parameters, llie emsdefs 
command affects the operation of the emsmks command. 

Terminates the network migration server. The emshalt command kills 
the njnning emsd processes and aborts any outstanding staging 
operations. 
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HSM Commands and Daemons 


Description (Continued) 


emsini'b 


Initializes the nerv\fork jiiigration server configuration files. If no 




configuration files exist, emsinit creates an initial configuration with 




no stores and standard default definitions. The emsinit command is 




normally only nin during installation. 


emslss 


Lists all configured stores, or individual stores selected by name or 




owning client. 


emsmks 


Makes a client store. You can also use emsmks to insert an existing 




store tree into a seiver configuration database. 


emsmvs 


Renames and/or moves an existing store. 


ems mis 


Removes an existing store. 


ems start 


Initiates the netw^ork migration seiver. 1 his has no effect if the 




network migration seiver is already running. The emsstart command 




is ixm during system startup. 


ems s tat 


Displays network migi'ation server usage statistics. It ciisplavs both 




cumulative and incremental statistics. Use emsstat to determine the 




cun'ent status of network migration senices. 


emstage * 


Explicitly stages out the specified files. You must be the file owner or 


the supemser to use this command. 


emstconf 


Creates new staging templates, removes existing staging templates, 




and changes parameters for existing staging templates. 


emsundel 


Starts a restore lun to retrieve bitfiles listed in the recover_Ust files. 




Only mn emsundel when an operator is available to handle volume 




mount requests. 


emsysconf 


Sets system-wide staging parameters in the configuration database. 


emvck 


Checks and corrects staging volume statistics, 'lliis is usually run from 




crontab. 


restage 


Stages or restage s files to the specified staging trail. 
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PartV 

Disaster 

Recovery 



Being Prepared 
for a System 
Disaster 



If there is a disaster, you should be prepared for a disaster 
recoveiy. However, fee] free to call Customer Service with 
questions. 

CAUTION: Do not wait for a disaster to read this 

chapter. The information in this chapter is 
about steps tliat must be taken with each 
backup so that you will be able to recover 
when a disaster occurs. 

'I'his chapter tells you how to prepare for the disaster recoveiy 
of your backup files. Tlie following two cliapters contain overall 
disaster recovery procedures to use when you experience a disk 
crash on an EDM server or client. Because each disaster is 
unique, these steps are presented only as a guide and not as all- 
inclusive, step-by-step instructions. 

CAUTION: Performing a disaster recovery requires 
experience with EDM Backup adminis- 
tration (and HSM administration, if you 
have the HSM option), UNIX system admin- 
istration, and the site environment. 
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You must establish a disaster strategy and safeguard your media 
and tlie reports before a disaster occurs. Otherwise, you will not 
have the necessary information to recover your system to its 
original state. 

Note: You should develo]? a disaster recoveiy plan that 
meets your specific organizational goals. Actual hie 
recover).' can be as simple as off-site tapes, or as 
complex as duplicate Symmetrix systems utilizing 
SRDF/Timefinder. 

To fully recover from a system disaster, you must run regular 
backups, safeguard your backup media, and run and save tlie 
appropriate backup reports. You can provide additional 
protection by creating redundant media and storing it offsite. 



SsfSQUSrCiillS Your To be prepared for a system disaster, you must run regular 

Backup Media backups and save the backup media for botli the current and 

previous full rotiition periods. For example, assume the 
following: 

» The rotation period is 7 days. 

• A full backup is run on Monday. 

» Every backup generates a single new piece of media. 

If today is Tuesday, you need the media tliat was generated 
since Monday of the previous week, or the last eight pieces of 
media. Tomorrow, you will need the same eight pieces, plus the 
media that is generated from today's backup. 

Be sure to save tlie backup media in a safe place, preferably 
offsite or onsite in a fireproof vault. 

CAUTION: Failure to have visually identifiable labels 
on removable media will significantly 
complicate and lengthen the Disaster 
Recovery procedure. 
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Running and Saving Reports 

Be sure removable backup media is physically labeled (such as 
with barcodes) so it can be visually identified if needed during 
the disaster recovery process. If barcoding is not used, each 
piece of media must be physically labeled with its assigned 
sequence number. 



Running and Saving At the end of your backups for the day, your 

BOpOrtS LOCAL_DATABASE is automatically backed up, which provides 

you an exact picture of tlie EDM Backup database. 

At the completion of ever>' LOCAL_DATABASE backup, the 
/usr/epoch/EB/config/local_db_cleanup script automatically 
generates a MINIMAL Disaster Report. By default, this report is 
emailed to all EDM Backup administrators, appended to 
/usr/epoch/EB/config/disaster-report.]og, and printed to the 
default system printer. 

CAUTION: It is essential that you save a hard or soft 
copy of the MINIMAL Disaster Report after 
each backup. Keep it in a fireproof location, 
either offeite or in an onsite fireproof vault. 

If the LOCAL_DA'rABASE work item remains in the schedule for 
more tiian 24 hours witliout being run, it will be forced to run 
immediately. 11iis is known as a iate" LOCAL_DA'rABASE 
backup. The work item remains in tlie schedule to be run again 
normally, or forced if needed. 

ebbackup displays a message and ebreport disaster notes a 
"late" LOCAL_DATABASE backup. 
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Being Prepared for a System Disaster 



MINIMAL Disaster Report 'Hiis minimal Disaster Report is a subset of the FULL Disaster 

Report that ebreport disaster generates. It provides essential 
infonnaiion that you need to perform a disaster recoveiy on the 
sen-'er — a list of media volumes for the most recent 
LOCAL_DATABASE backup, the cuirent EDM Backup configu- 
ration, the cun-ent Library Manager configuration, copies of the 
key configuration-file settings, and information about baseline 
backups. 

Note: This MINIMAL Disaster Report does no/ include 
backup client information. 



FULL Disaster Report you should run tlie FUIX Disaster Report once eveiy backup 

rotation and whenever significant system changes are made. 
The following example runs the FIJU. Disaster Report and 
redirects it to a file: 
emc# ebreport disaster > 
~sysadmin/disreports/960917 

See "Backup Disaster Reports" on page 16-19 for a description 
of the FUIX Disaster Report. 
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Redundant Backup In preparation for a possible disaster, it is recommended to have 

Coverage redundant backup coverage so tliat you can move some backup 

media offsite for safe keeping. Following are mo ways of 

providing redundant backups. 



Configure Alternate Media one good backup strategy is to configure an alternate media set 

Sets (TrailsetS) (trailset) for use on alternate nights. (A trailset contains all of 

the media that is used in performing llill and incremental 
backups for a backup schedule template in a single rotation 
period.) 

For example, with a rotation period of seven days: 

• with a primary trailset only, a complete trailset includes at 
least one full backup and six incremental for each work 
item. 

• with an alternate trailset, each complete trailset includes at 
least one full backup for each work item, but only two or 
three incrementals. 

With primary trailsets only, move backup media offsite as soon 
as it is older than one rotation period. With alternate trailsets, 
you can move each backup volume from one trailset offsite as 
soon as the volume is full. 



Media Duplication Another option is to use Media Duplication, which enables you 

to create a duplicate set of backup media automatically after 
each backup session. 

After you configure media duplication in the EDM Backup 
Configuration window, the duplication of a set of backup media 
occurs automatically after each backup session. You can then 
take the duplicate media offsite for safekeeping. 
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This method does not use network bandwidth and can be a 
good choice if you have extra drives. For more information, see 
Chapter 9 "Media Duplication". 
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Server from a 
Disk Failure 



This chapter contains disaster recovery procedures to use when 
you experience a disk crash on a backup server. Because each 
disaster is unique, these steps are presented only as a guide and 
not as all-inclusive, step-by-step instructions. 

CAUTION; Performing a disaster recovery requires 
experience with EDM Backup and HSM 
(optional) administration, UNIX system 
administration, and the site environment. 

To restore a backup server, determine the extent of the damage 
and disable backups, replace any damaged disks, reinstall tlie 
operating system, and reinstall any lost EDM Backup or HSM 
softv.'are. 

Prior to restoring lost files, you import the volume management 
and backup catalog database information and then use EDM 
Backup to restore die databases as tliey were at the time of the 
last LOCAL_DATABASE backup. After doing tliis, you can 
restore all of the data f]-om changes that occurred after the last 
LOCAL_DATABASE backup. 
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Recovering a Server from a Disk Failure 



The procedures in this chapter are based upon the example in 
Figure 20-1 that shows the actions that occurred before the 
disaster in the simplest case. Figure 20-2 illustrates these and 
other actions that may have occurred before the disaster. 



Figure 20-1 Disaster Immediately after the LOCAL_DATABASE Backup 



ABC 

A. Backup of filesystem with catalogs 




B. Remote client work item backup 

C. LOCAL_DATABASE backup 

Your disaster could occur immediately after your last 
LOCAL_DATABASE backup (Step C, above). If so, follow all of 
the sections except tliose that are marked "For changes after the 
last LOCAL_DAlABASE backup." 
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Figure 20-2 



Disaster after Other Possible Actions 



A 



B 



C 



D 



E 



F 



G 



Disaster 




A. Backup of filesystem with catalogs ^ 

B. Remote client work item backup 

C. LOCAL_DATABASE backup 

D. Appended backup 

E. Completion of duplication of volumes 
E Change in configuration of Library Units 

G. ebexpire (run either by cron or manual) 

H. Backups that completed after LOCAL_D AT ABASE backup 



Events, such as D, E, F, G and II in Figure 20-2, may have 
occurred (in any order) after the last LOCAL_DA1ABASE 
backup. If your disaster occurs after one or more of these, read 
ALL sections in the chapter, including tliose that are marked 
"For changes after tlie last LOCAL_DATABASE backup," and 
follow those tliat fit your situation. 



EDM SoUmre Reference 



20-4 



Recovering a Server from a Disk Failure 



Steps to Restore a Server The actions that are required to restore a sei-ver from a disk 

failure are discussed in this chapter. Follow the steps below to 
restore a backup senxr in case of a disk crash or major loss ol 
files, ^'our situation may \ary from this example and you ma\ 
not need all ofthe.se sections. If some filesyslenis remain inuict. 
you may be able to skip some .steps, ^'ou should adju.sl your 
disa.ster reco\'ery steps accordingly. 

^oLi need inlonnation from die Disaster Repcjrl for nian\ of 
these steps. For inf(jrmation about this repoit, .see "Running and 
Sa\ing Repcjits" on page 19-3- 

Note: 'I'he procedures lhal tcjHow use einc as ihe name of 
ihe senx-r .Siibstiiule the nami' of your f iwn sc-iTer 
in each of ihe examples 

Each of die following steps are described in tlie lollowing 
sections o\ this chapter. Perfonn them in the order gi\en. 

1. Stop All ActivitN' on the Sener 

2. Reinstall Hardware and Software as Needed 
^. Temporarily Rectjnfigure the Serwr 

1. Restore L<3(^\1,J)A-1ABASF Files 

'File next two steps are only done il you made ciianges after the 
last F()(:aL_1)ATAI3ASF backup. 

5. Reconfigure Libraiy Units 

6. Restore Catalogs and Backup Information Created After 
LOCAL_DATABASE Backup 

Follow these steps for all disaster recoveries. 

7. Restore Data Created Before LOCAL_DATABASE Backup 

8. Reenable crontab Entries 

9. Restore Past Catitlogs 
10. Restore Missing Catalogs 
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Stop All Activity on the 

Server 



Because you perform all of the restore in multiuser mode, you 
must notify the user community to stop all activit}' on the seiven 
No one should be able to log in. The sej-vei- must be inactive 
before you perfomi any disaster recovery procedures. 



Disable Activity 



Edit root's crontab file (/var/spool/cron/crontabs/root) on die 
server to comment out all backup and HSM staging commands 
that may start up automatically. Following are commands to 
comment out: 



00 0 * * * /bin/kill -1 "cat /usr/epoch/etc/mal /emmasterd. pid ' >/dev/null 
2>&l#EPCmalc 

15 23 * * * /usr/epoch/bin/emvck >/dev/null 2>&l#EPCmalc 

00 1 * * * /usr/epoch/bin/emcompact -c >/dev/null 2>&l#EPCmalc 

00 2 * * * /usr/epoch/bin/emscheck >/dev/null 2>&l#EPCmalc 

00 3 * * * /usr/epoch/bin/emsundel >/dev/null 2>&l#EPCmalc 

00 18 * * * /usr/epoch/EB/bin/ebbackup default >/dev/null 2>sl #EPCebs 

00 11 * * * /usr/epcch/EB/bin/ebexpire -expire -purge >/dev/null 2>&1 #EPCebs 

00 1 * * * /usr/epoch/EB/bin/ebcatclean -fix_saveset >/dev/null 2>&1 #EPCebs 

00 3 * * * /usr/epoch/EB/config/local_db__warning >/de¥/null 2>&1 tEPCebs 
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RSinStali HardWar@ and Before vou perform a restore, you must have your hardware 
Software as Needed and software in the same condition as tiiat before the disaster 

occurred. 

Determine the extent of the damage to botli hardware and 
sofTw^are. Be sure to identify? and i-eplace all damaged liardware 
before restoring any software. 

1. Check hardware and replace if necessarv'. You c^an use tlie 
disk diagnostics capability' of a program such as format to 
detemiine whether anything is wrong with your disk. 
Make sure tlie replacement hardware is fully compatible 
with the system you had before tlie disaster. Each new disk 
should have at least tlie same storage capacity as tlie old 
disk. 

CAUTION: Do not continue with software recovery 
until you are absolutely certain that the 
disks are free of hardware problems. 

2. Check the filesystems for loss of soft^\'are, starting witli the 
operating system. 

If / or Aisr was destroyed, reinstall the server's native 
operating system following the platform-specific instruc- 
tions that are provided with your server. Tliis partitions your 
disks, restores tlie root filesystem, and restores the portion 
of /usr tliat the operating sy.stem loads. 
To partition the disks correcriy. use the disk configuration 
data from the last Disaster Itepoit (whicli is described in 
^'Running and Saving Reports" on page 19-3) See 
Figure 20-3 on page 20-7. Make sure you rebuild these 
filesystems to the same size (or largeiO and the same 
number of inodes (or more) as they were before the 
disaster occurred. 
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Figure 20-3 Locally Mounted Disks from the Disaster Report 

Displaying locally mounted disks... 

/ (/dev/dsk/c0t3d0s0 ) : 8192 block size 1024 frag size 

230302 total blocks 92988 free blocks 69968 available 60416 total file 
56761 free files 8388632 filesys id 

ufs fstype 0x00000004 flag 255 filename length 

/usr (/dev/dsk/c0t3d0s3 ) : 8192 block size 1024 frag size 

673742 total blocks 295032 free blocks 227672 available 169920 total f 
153786 free files 8388635 filesys id 

ufs fstype 0x00000004 flag 255 filename length 

/ep_usr (/de\-/dsk/c0t3dDs4 ): 8192 block size 1024 frag size 
774766 total blocks 396532 free blocks 319072 available 196352 total f 
193845 free files 8388636 filesys id 

ufs fstype 0x00000004 flag 255 filename length 



3. If you liave an HSM system, you need to reinstall VERITAS 
VxFS. See your WRITAS File System (VxPS) Quick Start 
Guide. 

Note: If you are reinstalling the operating system, you 
need a VxFS license. 
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4. Verify whetiier the filesysiem that contains the backup 
software is damaged or missing (the EDM Software 
I'ilesystem, /ep_usr in tlie example in Figure 20-4). 

5. Check the Disaster Report to see wliat you had at the time 
of the last report. 



Figure 20-4 Displaying /etc/vfstab... from the Disaster Report 

Displaying /etc/vfstab... 



Oct 3 14:23 1998 /etc/vfstab Page 1 



Idevice device 


mount 


FS 






mount 


#to mount to fsck 
# 


point 


type 




at be 


lot options 


fd - /dev/fd 


fd - no 










/proc - /proc 


proc - no 










/dev/dsk/c0t3d0sl 


swap 










/dev/dsk/cOtSdOsO 


/dev/rdsk/cOtSdOsO 




uf s 


1 




/dev/dsk/c0t3d0s3 


/dev/rdsk/c0t3d0s3 


/usr 


uf s 


1 




/dev/dsk/c0t3d0s4 


/dev/rdsk/c0t3d0s4 


/ep___usr 


ufs 


2 


yes 


/dev/dsk/c0tld0s2 


/dev/rdsk/c0tld0s2 


/data 


vxf s 




yes 


/dev/dsk/c0t5d0s0 


/dev/rdsk/c0t5d0s0 


/datal 






yes 


/dev/dsk/cOtSdOsl 


/dev/rdsk/c0t5d0sl 


/data2 


vxf s 




yes 


/dev/dsk/c0t5d0s3 


/dev/rdsk/c0t5d0s3 


/dataS 


vxfs 


2 


yes 


/dev/dsk/c0t2d0s0 


/dev/rdsk/c0t2d0s0 


/data6 


vxfs 




yes 


/dev/dsk/c0t2d0sl 


/dev/rdsk/c0t2d0sl 


/data? 




2 


yes 


/dev/dsk/c0t2d0s3 


/dev/rdsk/c0t2d0s3 


/dataS 




2 


yes 


/dev/dsk/cOtOdOsO 


/dev/rdsk/cOtOdOsO 


/data3 






yes 


/dev/dsk/cOtOdOsl 


/dev/rdsk/cOtOdOsl 


/data4 


vxfs 


2 


yes 


sv/ap - /trap 


tmpf s - yes 
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6. Use the Installation Report portion of the Disaster Report to 
determine which of the various binaries were actually in 
/mr and which were symbolically linked to another 
filesystem. Tlie EpochBackup Installation Report section 
shows the directories and symbolic links for the backup 
software. 

In the third line of the split-install example shown in 
Figure 20-5 on page 20-9, the backup software is installed 
in /ep_usr/epoch and a symbolic link is in /usr/epoch and 
points to /ep_usr/epoch. 

Also, in this example, catalogs, db, and log are installed in 
/data/epoch/EB/' and a symbolic link is in /'usr/epoch/EB 
and points to them. 



Figure 20-5 Installation Report in the Disaster Report 

EpochBackup Installation Report for server adarn at Oct 13 09:01:14 1998 
Report options: -all 

Installed Software: 

EDM High-performance Centralized Backup with HSM 
abbreviation: edmhsm 
version: 4.0.0.5 
server platform: sun4_5.5.1 
platform: sun4___5.5.1 
patch id: none 
install date: 199711101657 42 

modules: EPCgl EPCtps EPCsnmp EPCesl EPCdevlib EPCdev EPCelralib EPCeli 
EPCebhslb EPChsesdm EPCmalib EPCmalc EPCmawrp EPCebsedm EPCebc EPCgui 
EPColdoc 

status: complete 

{Installation Report continued on next page.) 
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(Installation Report Continued from previous page.) 

Oracle Platinum On-Line Database Backup 
abbreviation: oraplt 
version: 1.1.0.5 
server platform: sun4_5.5.1 
platform: sun4_5.5.1 
patch id: none 
install date: 19971112104243 
modules: EPCoraplt 
status: complete 



EpochBackup currently running load 7.0.0.0 



/usr/epoch IS A SYMLINK to /epjdsr /epoch 
/usr/epoch/EB is a real directory under /ep_usr/epoch 
/usr/epoch/GENDIR IS A SYMLINK to /home/epoch 



1 



/usr/epoch/EB/adam is 
/usr/epoch/EB/bin is a 
/usr/epoch/EB/catalogs 
/usr/epoch/EB/client is 
/usr /epoch/EB/conf ig i; 
/usr/epoch/EB/db is a : 
/usr/epoch/EB/locks is 
/usr/epoch/EB/log IS A 
/usr /epoch /EB/preconfig 
/usr/epoch/EB/tmp 



1 directory under /usr/epoch/EB 
directory under /usr/epoch/EB 
IS A SYMLINK to /home/epoch/EB/catalogs 
real directory under /usr/epoch/EB 
real directory under /usr/epoch/EB 
1 directory under /usr/epoch/EB 
real directory under /usr/epoch/EB 
SYMLINK to /home/epoch/EB/log 

real directory under /usr/epoch/EB 
Lrectory under /usr/epoch/EB 



The local client is of the type: 
The client backup username is: 



sun4 v55 



The user ID for ebadmin is: 
The group ID for ebadmdn is: 
The home directory for ebadmin 



/usr/epoch/EB 



Client chip is of type ibm_rs6000_v325 <6. 0.0.0), installed Tue May 20 14:05:23 199 
Client yyz is of type windows__nt_all (6.0.0.0), installed Thu Sep 11 15:04:42 199 
Client perf-prol is of type windows_nt__all (5.0.1.0), installed Thu Sep 25 15:58 199 
Client pilgrim is of type sun_sun4_v54 (6.0.0.0), installed Thu Oct 23 15:53:58 199 
Client adam is of type sun_sun4_v55_srv (6.0.0.0), installed Wed Nov 12 11:03:07 199 

End of EpochBackup Installation Report for server adam at Mar 13 09:01:14 1998 
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7. Reinstall the backup softwaie. 

Use the data from the Installation Report section of the 
Disaster Report to determine where and how it had was 
installed most recendy (see Figure 20-5 on page 20-9). 

a. If the filesystem diat contained the backup software 
was destroyed, reinstall the software as a scratch instal- 
lation. See your Software Installation manual. 

b. If the filesysiem diat contained die backaip software is 
still intact but /usr was destroyed, you need to recreate 
the symbolic link from /'usr that points to this 
filesystem, wliich contains the backup software. 

To match the example in Figure 20-5 on page 20-9, 
enter the following (specify your own installation 
directory): 

emct In -s /ep_usr/epoch /usr/epoch 



Temporarily Reconfigure 
the Server 



You must configure the library unit by using Imconiig, and 
then a temporary backup configuration by using 
eb_server_config. 



Imconfig 



I. Obtain the Imconfig data from the Disaster Report 
(see Figure 20-6). 
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Figure 20-6 Library Manager Configuration from the Disaster Report 

Displaying library manager configuration (used with Imconfig...) 





Lu_name 




Name 


ID 


Status 


L 


offline_0 










L 


offsite_0 








sync6d 


L 


at_dlt_3264^ 


_0 




(0,1,1,0) 


synced 


D 


at__dlt_3264 


_0 


drive_0 


(0,1,5,0) 


enabled 


D 


at_dlt__3264 


0 


drive 1 


(0,1, 4,0) 


enabled 


D 


at_dlt_3264_ 


__0 


drive_2 


(0,1, 3,0) 


enabled 


L 


hp____mf_cl7xx^ 


_0 




(0,2, 6,0) 


synced 


D 


hp_mf_cl7xx_ 


_0 


drdve^O 


(0,2, 5, 0) 


enabled 


D 


hp_mf_cl7xx 


0 




(0,2, 4,0) 


enabled 


D 


hp_mf__cl7xx^ 


^0 


drive_2 


(0,2,2, 0) 


enabled 


D 


hp___mf_cl7xx_ 


_0 


drive__3 


(0,2, 1, 0) 


enabled 








Remove all of the media from tlie lib 
configured and put the media aside, 


~aTy unit that you just 
n their own box or 



some other location where they cannot be confused with 
other media. You reuse these media when you restore tlie 
catalogs (see page 20-23). 

This significantly shortens the lime that is required to 
inventoiy this libraiy unit when you reboot the sei-ver. 
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3. Using knconfig, install the drivers for a library unit tlifit 
supports the media you use later to import and restore the 
LOCAI_DATABASE backup. 

See Chapter 17 "Configuring Library Managers" for details 
about running Imconfig. 

Note; You can save a significant time by configuring only 
one iibrar)' unit, even if more than one is available. 

4. Use the CONFIG option of Imconfig to configure the 
library unit. 

Note: If you use the AUTOCONFIG (jption, you must 

leave at least one piece r)f media in the TLU. If you 
do tlii.s, leave the piece of media rec|uired for 
I.f)CALD,ArABASF. restcjre. 

5. Using the I.OCAl _DA'lABASr, volumes section of tlie 
Di.saster Report (see Figure 20-^ on page 20-16). reinsert die 
\ c)lumes that contains the LC)CA1_DATABASE backup into 
the library unit that you ccmfigured. 

6. Reboot the .server again witli the iollowing command: 

/usr/sbin/shutdown -y -i6 -gO 

The Library Manager performs an inx'entfjn- of this library' 
unit. Wlien the in\'entoiy is complete, ctjniinue to the next 
step. 



Configure a temporary EDM Backup configuration, The original 
EDM Backup configuration is restored later, when you restore 
the LOCAL_DATABASE files as described in tlie next section. 
1 . Detemiine whether the backup server software was a split 
directory or single directory server configuration. 
Look at the Installation Report in the Disaster Report (see 
Figure 20-5 on page 20-9). 
a. If catalogs, db, and log are real directories, not 
SYMLINKs, you have a single directoiy installation. 
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b. If eidier catalogs, db, or log are SYMLINKs to another 
directory, you have a split directory installation. 
2. Run eb_server„config and respond to the prom]3ts to 
recreate the installation and configuration of the server, as 
indicated in the Installation Report. 

a. If the previous installation was a single directory' instal- 
lation, you need to select no when asked if you wish to 
install into a "split" directory. 

b. If the previous iastallation was a split directory instal- 
lation, you need to select jes when asked if you wish to 
install into a "split" directory. 

c. Determine the parent directory of the catalog, db, and 
log directories (in f^igure 20-5 on page 20-9) that would 
be ./usr/epoch/EB, and enter that path when asked for 
the name of the target directory. 

d. Detemiine the client backup username by examining 
the Installation Report of tlie Disaster Report 

(see Figure 20-3 on page 20-9), and enter it when 
asked. 

e. Answer the remaining questions as you did in tlie 
original installation and as shown in the Disaster 
Report. 
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Restore LOCAL DATABASE Once all hardware and software are in place, and you tempo- 

FileS rarily reconfigured the server, you need to restore your most 

recent LOCAL_DATABASE backup. 

1 . Import the original or the duplicate volumes that contain 
the LOCAL_DATABASE backup (which was inserted at step 
5 on page 20-13) into tlie Volume Manager catalog. To do 
this, enter: 

emc# evmimport -1 LibraryUnitNanie -a 

where UbimyUnitName is the name oi' the library unit you 
configured earlier in the procedure. The -a option causes all 
of the volumes in that libraiy unit to be imported. 

2. Use the LOCAL_DATABASE section of the Disaster Report 
(see Figure 20-7) to get the saveset ID and first volume ID 
of the LOCAL_DATABASE backup. 

Note: If you plan to use duplicate volumes, you only need 
to load the duplicate volumes in the libraiy unit. If 
the original volume is in the offline state, the substi- 
tution of duplicates happens automatically. Always 
use the original volume ID when needed in the CIJ 
commands or in the ebimport CLl, do not use the 
duplicate volume ID. 
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Figure 20-7 



EDM Backup MINI^mL D: 
LOCAL_DATABASE Backu| 
The following volume: 



LOCAL_DATABASE Section of the Disaster Report 
Saveset ID Original Volume ID Duplicate Volume ID 

"elf 7 on May 18 13:05:42 1999 



which will be required in the even' 



Volumes Repo 



contain the nost recent L0CAL_DATABASE backup 



Saveset ID |7271A0D4 . 374Q8006[ for L<)CAL_DATABaSE backup on 5/17/99 16:45 




backup_DLT #0010 |( 38DD01FC8C977D9^ ) [original] - currently in 
library unit "de_dlt_x7 00_0" , slot #5 

backup_DLT #0011 |"7EiDD020907E79824 ) [duplicate] - currently 

library unit "de_dlt_x700_0" , slot #3 
This LOCAL_DATABASE backup will require 27.2 MB of disk space to be recovi 

3. Import the LOCAL_DATABASE backup to restore the 
saveset records and catalogs. 

Run ebimport using the -media option (with the 
l6-character original volume ID listed in parentheses for the 
LOCAL_DATABASE backup volume) and tlie 17-character 
LOCAL_DATABASE saveset ID, as follows; 

emc# ebimport -media 38DD01FC8C977D94 7271A0D4 . 37408006 

I I 

Original Volume ID Saveset ID 

At this point, enough data is restored to restore the 
LOCAL_DATABASE backup. 

4. Make sure catalog processing completed. To do this, enter: 
emc# ebcatalogd -status 

When it reports that all catalogs are processed, continue to 
the next step. 
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5. If you have an HSM system, reconfigure all migration 
controlled filesystems that must be restored. 
Refer to emlsconf output (see Figure 20-8 on page 20-18) 
in the Disaster Report and use exactly the staging param- 
eters that it reports as argviments to the emsysconf, 
emstconf, and emf'sconf commands. Valuable control 
information was lost when the filesystems were damaged 
then recreated. This control information is recreated when 
you run emfsconf. 
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Figure 20-8 EpochMigration Local Configuration from the Disaster Report 

EpochMigration Local Configuration 

EpochMigration System Configuration: 

Enable_stage_DutMax_trailsEnable_self _describing 

Y 3 N 

Staging trail "Retrieve_random" 

Stage outs enabled: Y Media: EO Unrestricted 
Self-Describing enabled: N 

Enable HWM LWM PSWM Delay Mntpoint 

Y 68 34 17 0 defaults for Retr ieve^random 

Staging trail "Retrieve_cached" 

Stage outs enabled: Y Media: EO Unrestricted 

Self-Describing enabled: N 

Enable HWM LWM PSWM Delay Mntpoint 

Y 95 88 80 0 defaults for Retrieve^cached 

Staging trail "Archive" 

Stage outs enabled: Y Media: EO Unrestricted 

Self-Describing enabled: N 

Enable HWM LWM PSWM Delay Mntpoint 

Y 68 34 17 0 defaults for Archive 

Staging trail "Trail_l" 

Stage outs enabled: Y Media: EO Unrestricted 
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6. Select a temporary location for LOCAL_DATABASE. 

CAUTION: You cannot use a filesystem that is enabled 
for HSM for the temporary location of the 
LOCAL_DATABASE. (See Figure 20-8 on 
page 20-18 for the configuration of such a 
filesystem.) 

CAUTION: The 1XKAL_DATABA.SE backup must not be 
restored in place (to its original location), 
or the temporary database files that were 
just created and are being used to restore 
the original database are overwritten. This 
causes the disaster recovery process to faiL 

You must have a filesystem witli enough fj-ee disk space to 
restore the LOCAL_DATABASE backup to a temporaiy 
location. Tlie ainount of required disk space is noted in the 
IX)CAL_DA'1'ABASE portion of die Disaster Report (see 
Figure 20-7 on page 20-16). If the filesystem you choose is 
the same filesystem tliat contains the EDM software, you 
need twice as much free disk space as noted in the Disaster 
Report. 

7. Use ebrestore (not the EDM Restore window) to restore 
the LOCAL_DATABASE backup to the temporary location 
determined above, such as 
/newpath,''newdir/temp_local_db. 

This restores critical files oilginally located in /usr/epoch. 
emc# mkdir -p /newpath/newdir/teii:^_looal_db 
emc# ebrestore -w emc : LOCAL_DATABASE -c emc -D emc 
-d /newpath/newdir/temp_local_db / 

Note: In "~w emc : LOCAL_DATABASE, " "-c eiric, " 
and "-D emc," "emc" is the name of the seiver. 

8. Now run a full label and barcode inventon' to avoid 
duplicate entries in the catalog. You can run an inventory 
by using tlie evminventory command (refer to the 
evminventory man page), or through the Library Unit 
Manager window. (Refer to EDM online help for more 
information.) 
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9- Stop the following on the server as shown: 

a. Stop catalog processing by halting the ebcatalogd 
daemon. To do this, enter: 

emc# ebcatalogd -halt 

Note: emfmd must be running on HSM ser\'ers. 

b. List the applicable backup, volume management, and 
HSM daemons with the following command: 

einct edmproc 

c. Stop the daemons with die following command: 
eiiic# edmproc -shutdown 

d. Verify that all processes are stopped. 
emc# edmproc 

On an HSM system, emfmd should still be running. On 
a system without HSM there should not be any 
daemons still mnning. 
10. After the required shutdowns, move the LOCAL_I)A'rABASE 
from the temporary location to its permanent location. 

Note: Tliere are nvo copies of eb__disaster_move. Be 
sure to use tlie copy relative to the temporar)' 
location of LOCAL_DATABASE as showi in these 
instructions. 

CAUTION: Do NOT use the copy in: 

/usr/epoch/EB/conf ig/ 

To do this, change to the temporary location: 
emc# cd /newpath/newdir/tenip_local_db 

Then find the path of the relative eb_disaster_move, cd to 

it and verify that you are there: 

emc# find . -name 6b_disaster_move -print 
emc# cd <path containing eb_disaster_niove> 

emc# pwd 

Move the LOCAL_DATABASE to its permanent location by 
using eb_disaster_move: 
emc# . /eb_disaster_inove 
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Note: Regarding use of dupMcate volumes: 

When eb_disasler_move completes, it automatically 
checks for failed and uncompleted duplications. If a 
duplication failed, you must use the original volume 
for restore. If tiie duplication had not completed or 
was scheduled, at the time the catalog was written 
to tape, the duplicate will be available for use. 

If the disaster occurred soon after the backup 
completed, these duplications may not have 
completed. If there are errors reported during the 
restore while using the duplicate, use tlie original 
volume. If you do not have the original, contact 
Cu.stomer Service to restore from an earlier 
duplicate. 

After you have completed the disaster recovery, 
reschedule the duplication of thtise original volumes 
that were not successfully duplicated. 

/newpath/newdir/temp_local__db remains after 
eb_disaster_niove is done but is no longer 
needed. You may wish to delete it after 
completing all disaster recovery procedures. 

Any modifications to the eb.cfg file that were made after the 
LOCAL_DA1'ABASE backup must be added manually to the 
restored eb.cfg file. You cannot restore any of the catalogs 
after the local_db backup (such as a new work item), until 
this is done. 

Note: If you want to use duplicate volumes that were 

made after the LOCAL_DATABASE backup, follow 
tire instructions in "Restore Catalogs and Backup 
Information Created After LOCAL_DATABA,SE 
Backup" on page 20-23. 



EDM Software Reference 



20-22 



Recovering a Server from a Disk Failure 



11. Restart the following as shown: 

a. Restart the Volume Management daemon with tlic 
following command: 

emc# sh /usr/epoch/etc/roS/S20elm start 

b. Restart ebfs with tlie following command: 

emc# sh /usr/epoch/etc/roS/S30ebfs start 

c. If you have an HSM system, reenable staging with the 
following command: 

einc# sh /■usr/epooh/etc/rcS/S40mal start 

You do not restart tlie ebcatalogd daemon at this time. It is 
restarted after you reboot the seiver. See "Stop Backups" on 
page 20-23. 

12. Eliminate any incomplete backups or catalogs that could 
confuse catalog pi-ocessing. To do this, enter: 

emc# ebexpire -partial -purge -expire 

13. Ensure tliat all catalogs that you just restored are in sync 
with tlie saveset database. To do this, enter: 

emc# ebcatclean -disaster 

This completes the restore of the LOCALJ3ATABASE backup 
which contains the seiver catalogs and backup inlormation at 
the time of the last LOCAL_DATABASE backup, llie LOCAL 
_DATABASE is no longer available (or needed) for the restore 
process. If you need it again, .start at step 6 on page 20-1 9. 

At this point, the server's library units are configured as they 
were at llie time of the last LOCAL_DATABASE backup. If there 
were no significant events after the LOCAL_DATABASE backup 
(Step C in Figure 20-1 on page 20-2), enter ebcatalogd on the 
command line to restart the daemon and skip to "Restore Data 
Created Before LOCAL_DATABASE Backup" on page 20-28. 
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Reconfigure Library Units For changes after the last LOCAL.DATABASE backup 

If any library units changed their configuration after the 
LOCAI._DAl"ABASE backup was generated (step C in Figure 
20-2 on page 20-3), use Imconfig to reconfigure tliem. 'lliere is 
no information in the Disaster Report to assist you in this step, 
since these changes (if they occurred) happened after the 
Disaster Report was generated. 



For changes after the last LOCAL_DATABASE backup 

If any of the events, such as D, E, F, or G in Figure 20-2 on page 
20-3, occurred after your last LOCAL_DATABASE backup, you 
should get the catalogs and backup information back as soon as 
possible. 

This applies, if you are using duplicate media which completed 
after the LOCAL_DATABASE backup. 

To do this, you need to stop all backups, run a full inventory, 
import volumes, and then restore the catalogs and backup infor- 
mation. 



Stop Backups Disable backups by commenting out any ebbackup, ebexpire, 

and ebcatclean commands in the root crontab file. This needs 
to be done again because root crontab may have been modified 
when you moved LOCAL_DATABASE from the temporary 
location to die permanent location. 

Reboot the seiver with tlie following command: 
emc# /usr/sbin/ shutdown -y -i6 -gO 

This starts vmdaemon and ebcatalogd and makes all of your 
library units avaOable to use in the remaining restore process. 



Restore Catalogs and 
Backup Information 
Created After 
LOCAL_DATABASE Backup 
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Run a Full Inventory and l. Take the box of tapes you set aside in step 2 on page 20-12 

Import Uncataloged Volumes and insert the tapes in the library unit. 

2. Inventoiy the contents of tlie library unit: 
emc# evminventory -1 at_dlt_452_0 -a -L 

Where -1 = library name, -a = all slots, and -L = Verily Label 

3. Then import all uncataloged volumes in the library imit. 
emc# evmimport -1 at_dlt_452_0 -a 

Where -1 = libraiy_name, -a = all slots (uncataloged only) 

4. Wait until the inventories complete before proceeding. 



Import Backup Catalogs and Next Impon the current catalogs for the current rotation. 

List Volumes -| ^ identify' these, run ebreport media and select the most 

recent volume in the most recent rotation for each trail (as 
noted by a in the example in Figure 20-9). 
emc# ebreport media 
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Figure 20-9 Output from ebreport media 

EDM Backup Media Report for server rrdssile on May 9 14:22:22 1999 
Report options: none 



Rotations for Template "usr_bin". Trail "usr___bin___DLT" , Primary Trailset 
09/30/1998 12:54:42 Rotation ID: 4CD84987 . F6BECF8D. 00000200 . 54028F30, 4 backups 

Media duplication used on 1 copy 
*Orig Vol: 60D8 4A1170094B3E (BNY574), Seq #: 000024 in TLU: at_dlt__3264_0, media: DM 
Dup Vol: 73D8745B3ED384A5 (BDE133) , Seq #: 000028 in TLU: at_dlt_3264^0, media: DM 
Duplication State: Done, Successful, Duplication Date 05/08/1999 16:06:0' 
Orig Vol: 4CD84 987F6BECF8D (ASV891), Seq #: 000027 in TLU: at_dlt_452_0 , media: DL' 
Dup Vol: 96D8746209A96A98 {BDE128), Seq#: 000031 in TLU: at__dlt_452_0, miedia: DL' 
Duplication State: Done, Successful, Duplication Date 05/08/1999 16:25:0' 



EDM Baseline Media Report for server adam on May 9 13:10:26 1999 



2. Run ebimport to import the backup catalogs and infor- 
mation trom tlie volumes tliat were cuiTcnt at the time of 
the last successful LOCAL_DATABASE backup (identified by 
an * in the output from ebreport media, as shown in the 
above example). 

These volumes may also contain appended l^ackups not 
known at the time of the last LOCAL_DATABx4SE backup. 
(These volumes may reside inside or outside tlie library 
units.) 

Note: Tliis portion of the restore can take a considerable 
amount of time because EDM Backup lias no record 
of the backups or the volumes on which lliey 
reside. 
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3. For each volume, run tlie following command to import 
catalogs and backup information created after the time of 
the LOCAL_DATABASE backup: 

emc# ebimport -media vol id -clevel 9 -level 9 

Some catalog imports may fail. If so, stop the catalog 

daemon and restait it with the 30 second option, which 

causes these catalogs to be processed again in 30 seconds 

rather than the default value of one day. 

emc# ebcatalogd -halt 

emc* ebcatalogd -retry_time 30 

If you make this change you should reset ebcatalogd after 
completion of the disaster recovery. To do this, enter: 
emc# ebcatalogd -halt 

emc# ebcatalogd -catalogs 3 >& /dev/null 

4. Execute the following command to list all volumes in the 
library unit and their states: 

emc# evmstat -v 

If there are any "uncataloged" volumes that are allocated after 
the last LOCAL_DATABASE backup, you must restore the 
catalogs and backup information. Otherwise skip to "Restore 
Data Created Before LOCAL_DATABASE Backup" on page 
20-28. 



Restore all catalogs and backup information that were created 
or changed and backed up, staged, or part of a baseline backup 
after the LOCAL_DATABASE backup completed. (See 
Figure 20-2 on page 20-3.) Tliis is restoring data from volumes 
tliat were allocated after the last LOCAL_DATABASE backup. 

Note: Ihis portion of the restore can also take a consid- 
erable amount of time. 
1. Run a dbreport volume, sort the output and redirect to a 

file as follows: 

emc# dbreport volume | sort > pre. sort 



Restore Catalogs and Backup 

Information 



EDM Software Reference 



20-27 

Restore Catalogs and Backup Information Created After LOCAL_DATABASE Backup 



2. Use the EDM Library Unit Manager window in the liDM 
GLT to import all uncataloged volumes, when a backup was 
appended to a previous baclcup after the 
LOCAL_DATABASE was backed up. 

Note: If you are doing a partial disaster recoverv% and are 
skipping over portions of this chapter, be sure that 
the value of VM_ALLOW_DUP_SEQJMPORT in 
/'usr/epocli/'etc/vw'vm.cfg is set to "no," which is 
the default setting tliat allows the overwriting of 
a duplicate sequence number. 

Look at which volumes are offline. Select all uncatalogued 
volumes and import them. When a message appears asking 
if you want to overwrite a duplicate sequence number, 
answer yes. Tliis makes the latest backup to lliat trail 
available. 

3. Run another dbreport volume, this time redirecting the 
sorted output to post.sort: 

emc# dbreport volume | sort > post.sort 

4. Run a diff on the two files: 

enic# diff pre . sort post . sort 

Examine the output for volumes tliat changed from 
"available" to "allocated." Tlie following is an example of 
diff output that shows an EB volume that changed from 
"available" to "allocated:" 

media application volume__nanie seq side barcode state volid 



DLT EB Server__alt_DLT 147 0 00000327 available 280"^ ;bFA4 ^ 7 5B4 

DLT EB Server_alt_DLT 147 0 00000327 allocated 123456EA44E275B4 

The second column indicates which EDM application uses 
the volume. EB indicates EDM Backup, EM indicates an 
HSM volume, and baseline indicates a baseline backup. 
For EDM Backup volumes that changed, enter: 
emc# ebimport -media volid -clevel 9 -level 9 
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For EM or baseline volumes that changed, enter: 
emc# ebfs_import -v vol id 

Run ebcatalogd -status until it reports that all catalogs were 
processed. 

At this point, you have restored all of your most recent server 
catiilogs and backup information that were complete at die time 
of the last LOCAL_DATABASE backup and those completed 
after the last LOCAL_DATABASE backup. 



You need to restore user files and some catalogs wWch were 
created before the LOCAL_DATABASE backup. 

Before you begin tliis section, restart the ebcatalogd daemon if 
you did not do so in tlie previous section. To restart the 
daemon, enter the following command at the command line: 

# /usr/epoch/EB/conf ig/daemon_startup 

1 . Use ebrestore with the overwrite option set to never to 
restore each sei-ver work item you need to restore your 
file.systems and partitions, and any customized operating 
system files such as /.login, /.cshrc, /.profile, network 
databases, and crontab files as they were at tlie time of the 
last LOCAL_DATABASE backup. 

# ebrestore -o never -i 

The -o never option ensures that you do not overwrite any 
files that you already restored, such as / and /usr which 
were reinstalled in Step 2 on page 20-6. Oveiwriting them 
may crash the system. 

CAUTION: You use the -o never optioo so that you do 
not restore all of / and /usr; since dokig so 
may crash the system. For example, if you 
overwrite /usr/Hb/libcso.l on a Solaris 
machine you crash the system. 

However, you may want to restore some 
specific individual files selectively with 
custom settings (such as /etc/hosts and 



Restore Data Created 
Before LOCAL_DATABASE 

Backup 
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/etc/passwd) or programs loaded into 
/usr/local or /usr/etc for local use using 
ebrestore with overwrite set to always. 

At this point, you should have restored all filesystems and parti- 
tions tliat were present on the server up to the last 
L0CAL_DA:L4BASE backup. (If you have an HSM system, EM 
and HSM now reattach properly.) 

2. If an entire HSM VxFS filesystem was lost, you can do the 
following to restore dieir data quickly; 

a. Remount the filesystem without logging: 

emc# mount -F vxfs -o remount , nolog /homel 

b. Perform the restore using ebrestore or the EDM 
Restore window. 

c. Remount the filesystem with logging when the restore 
is complete: 

emc# mount -F vxfs -o remount, log /homel 

3. If you restored any system files, reboot die sender. 

Note: Do not attempt multiple restores from the same trail 
simultaneously. This slows down the restores signif- 
icantly. 
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Beenable crontab Entries Reenable backups by undoing any edits you made to the root 
crontab file in "Disable Activity'" on page 20-5 or "Stop 
Backups" on page 20-23. 

If you do not want to restore past catalogs that allow you to 
restore older data, the recoveiy of the seiver is complete at this 
point. 



If you want to restore your earlier catalogs (which tlien allows 
you to restore earlier backup data), continue with this section. 
These backup catalogs provide a histoiy of backups completed 
prior to the last LOCAL_DATABASE backup. 

You know which catalogs were not yet restored because 
ebreport history may report savesets with ??????? in the 
Entries field. This indicates that tlie catalogs for tliose backups 
must be imported or restored before the backups can be 
restored. 

1 . Use ebrestore to restore the rest of the backup catalogs. 
Set the oveiw-rite option (-o) to never. 
emc# ebrestore -c emc -D emc -o never -d / -w emc:/da.ta 
/data/ epooh/EB/ catalogs / 

In this case, emc:data is the name of work item that backed 
up the partition on which die EDAI Backup catalogs wej'e 
stored, and /emc/'data/epoch/EB/ is where the EDM 
Backup catalogs were stored (see the example in 
Figure 20-5 on page 20-9). 

At this point you restoi-ed all of the backup catalogs up to 
the last LOCAL_DATABASE backup. 
Run ebexpire -partial -purge -expire to eliminate any 
incomplete backups or catalogs that could confuse catalog 
processing. 

Make sure all catalogs were processed. 



Restore Past Catalogs 
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a. Run ebcatproc -any to start catalog processing for 
these particular savesets, 

b. Run ebcatalogd -status. Continue when ebcatalogd 
reports tliat all catalogs were processed, 
ebcatalogd may indicate that some catalogs failed. If 
so, run ebcatalogd -halt to stop the catalog daemon 
and restart it witli the -retry_time 30 option, which 
causes these catalogs to be processed again in 30 
seconds ratlier than the default value of one day. 

If you make this change you should reset ebcatalogd 
after completion of the disaster recov^ery. 'f'o do this, 
enter: 

emc# ebcatalogd -halt 

emc# /usr/epoch/EB/config/daeHion_startup -^catalogd 

emc# 

At this point, you restored the full EDM Backup catalog 
system (except for the most recent remote client catalogs 
which are discussed next). 

4. Now, you can restore any backed-up data that was not 
present on the sender at the time of tlie LOCAL_DATABASIi 
backup, by using the ebrestore -o never command, 
enicl ebrestore -o never 
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RSStOrS MiSSiny Cst^lOyS as a final step to restoring your data in a disaster situation you 
must make sure that you restored all of tlie missing backup 
catalogs. Tliese backup catalogs were neither backed up by the 
work item for the partition contJiining the catalogs nor were 
diey part of the LOCAL_DATABASE backup. 

1 . To determine which catalogs were not backed up prior to 
the LOCAL_DATABASE backup, run the ebreport history 
command with the -cbimport option. 

emc# ebreport history -ebimport 

This report displays ??????? in the Entries field if the 
saveset indicates die backup was complete but tlie catalog 
has not yet been restored. 

hi the example shown in Figure 20-10 on page 20-33, nine 
backups are missing tlieir catalog files. 

2. Identify the savesets that were not restored and import each 
one by using the following command: 

emc# ebimport -clevel 9 -level 9 -ok_if_unexpired saveset_id_l . . . 
saveset_id_i2 

This restores the catalogs even if tlie saveset database 
indicates they are not yet expired. 
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Output from ebreport history -ebimport 



Primary Trallset **** 



1/ 3/98 : 

SavesetID — 



Lvl ID Status 
. 0 5542Fa53.2D28D220 sorted 



**Item "lamborgini" 
Time Lvl : 

7/ 3/97 0:31 

6/31/97 19:; 



554 2FA53.2C350E95 complet' 
5542FA53 . 2C0A93DB comple 



Entries Expires serverdb 

??????? 1/ 3/99 

Entries Expires serverdb 

! ??????? 5/31/99 



Time Lvl ID Status 

6/14/97 21:31 0 5542FA53 . 2C1D2 6F6 complett 
5542FA53.2BF82217 complex 



5/17/97 19:40 



*ltem "support" 



Entries Expires serverdb 
??????? 6/14/90 
??????? 5/17/90 



Entr: 



Time Lvl ID Status 

7/16/97 23:31 0 5542FA53 . 2C4773D6 complete ?????1 
6/17/97 21:44 0 5542FA53 . 2C211F44 complete ?????' 
5/20/97 19:42 0 5542FA53 . 2BFC1 897 complete ?????■; 
4/30/97 19:49 0 5542FA53 . 2BE1BBA0 complete ?????' 

Of the backups listed, 9 are missing catalog files. 



s Expires 

? 7/16-/99 
? 6/17/99 
? 5/20/99 
? 4/30/99 



Those backup: 
cannot be rei 

"ebimport -ok_if _unexpired" 



hose count of catalog entries are filled with " 
ered until their catalogs have been recovered by running 
the backup' : 



For information on restoring a UNIX client see Chapter 21 
"Recovering a UNIX Client from Disk I^ailure." 
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Recovering a 
UNIX Client 
from Disk 
Failure 



lliis chapter contains disaster recovery procedures to use when 
you experience a disk crash on a UNIX client. Because each 
disaster is unique, these steps ai'e presented only as a guide and 
not as all-inclusive, step-by-step instiuctions. 

CAUTION: Pei-forming a disaster recovery requires 
experience with EDM Backup adminis- 
tration (and HSM administration, if you 
have the HSM option), UNIX system admin- 
istration, and the site environment. 

In general, to restore a lost EDM client, you must replace tlie 
damaged disk, reinstall tlie operating systan, reinstall (or relink) 
to any lost EDM client software, and use the EDM Restore 
window to restore your lost files. 

If you also need to restore the backup server, be sure to restore 
the server first, befoj-e you restore tlie client. The following 
procedures assume that the EDM Backup server is not damaged 
or was already restored. 

Note: This chapter applies to UNIX clients. Refer to the 
appropriate client supplements for recovering other 
clients. 
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Recovering a Client Because you perform all of tlie restore in multiuser mode, you 

must notify? the user community to stop all aclivit}' on the client. 
No one should be able to log in. Tlie client must be inactive 
befoi'e you perfomi any disaster recovery procedures. 

The following procedures also assume tliat all of the client 
filesystems are damaged or unavailable. If some filesystems 
remain intact, you might be able to skip some steps, lliese are 
guidelines only. 



Beginning Steps To restore an EDM client in case of a disk crash or major loss of 

files: 

1. Edit root's crontab file on the server to comment out all 
backup and staging commands that might start up automat- 
ically. Comment out the following entries (note tliat some 
are HSM-specific (begin with em) and apply only to EDM 
Migration clients): 

00 0 * * * /bin/kill -1 'cat /usr7epoch/etc/mal/emmasterd.pid' >/dev/null 
2>Sl#EPCn\alc 

15 23 * * * /usr/epoch/bin/emvck >/dev/null 2>&l#EPCmalc 

00 1 * * * /usr/epoch/bin/emcompact -c >/dev/null 2> sltEPCmalc 

00 2 * * * /usr/epoch/bln/einscheck >/dev/null 2>&l#EPCmalc 

00 3 * * * /usr/epoch/bin/emsundel >/dev/null 2>&l#EPCmalc 

00 18 * * * /usr/epoch/EB/bin/ebbackup default >/dev/rmll 2>sl #EPCebs 

00 11 * * * /usr/epoch/EB/bin/ebexpire -expire -purge >/dev/null 2>&1 #EPCebs 

00 1 * * i /usr/epoch/EB/bin/ebcatclean -fix_saveset >/dev/null 2>&1 #EPCebs 

00 3 * * * /usr/epoch/EB/config/local_db__warning >/dev/null 2>&1 #EPCebs 
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2. Check hardware and replace if necessaiy. Run a disk 
diagnostics program. Be sure to identify and repktce all 
damaged hardware before performing any softv^'are 
recoveiy procedures. Make sure replacement hardware is 
fully compatible witli the system you had before the 
disaster. Each new disk should have at least the same 
storage capacity as the old disk. 

3. Reinstall the client's native operating system. For directions, 
see the documentation that is supplied with the client. Iliis 
reinstall process partitions your disk, restores the root 
filesystem on the client, and restores that poition of /usr that 
the operating system loads. Make sure to specify tliat these 
filesysteins are at least as large as and have the same (or 
larger) number of inodes as tliey had before the disaster. 

CAUTION: Do not continue with software recovery 
until you are absolutely certain the disk is 
free of hardware problems. 

If you are recovering a Backup client, go to step 6. 
If you are recovering an HSM client, go to step 4. 



For HSM Clients Only 4. if the client is an EDM Migration client, reinstitll VERITAS 

VxFS filesystems. Customer Service has the Softimre Instal- 
lation manual, call them with questions. 

Go to step 6. 
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For Backup and HSM Clients 5. Reinstall the EDM Backup software using 

eb_install_cllent. Reconfigure EDM Backup on the client, 
using exactly the same settings as tliose defined prior to the 
disaster. 

Refer to the full ebreport disaster report as necessary, for 
a list of the workitems prior to the disaster. 

CAUTION: Do not restore all of / and /usr; doing so 
may crash the system. Only restore those 
files that contain customized settings; for 
example, /etc/hosts and /etc/passvvd, or 
programs that are loadai into /usr/local or 
/usr/etc for local use. 

6. Create and mount new, empty filesystems that are identical 
to (in terms of number of blocks and inodes), or larger 
than, those on the client before die disaster. Note that the 
commands used and command syntax vaiy from plati'orm 
to platfomi. For a Sun workstation, for example, use newfs, 
mkdir, and mount. Refer to tlie ebreport installation or 
a full ebreport disaster report for a list of client filesystems 
and their sizes prior to the disaster. 

7. if tlie filesystem that contained the backup softw-are is still 
intact, but /usr was destroyed, you need to recreate the 
symbolic link from /'usr pointing to this filesystem tliat 
contains the backup software. 

If you are recovering a Backup client, go directly to step 12. 
If you are recovering an HSM client, go to the next section, 'Tor 
lISM Clients". 
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For HSM Clients when recovering an HSM client, verify whethei- the EDM 

software (/ep_usr) is damaged. 

• If it is not damaged, use the following steps in this order: 
step 9-, on page 21-5 step 10., on page 21-5 and step 5., on 
page 21-4 

• If it is damaged, use the following steps in this order: step 
8., on page 21-5 step 10., on page 21-5 step 5., on page 21- 
4 step 11., on page 21-5 and tlien step 9., on page 21-5 

8. Reinstall the EDM Migration (mc) software using 
ep_mstall. 

9. Run emlsconf to display the old configuration. Any newly- 
created filesystems must be reconfigured for migration even 
if the MAL database files look intact. The commands are: 

# emlsconf -r filesystem 

# emfsconf filesystem old_parameters 

where old Jjarametem are the emfsconf parameters 
displayed by die emlsconf command. 

10. Shut down the HSM daemons prior to restoring the EDM 
software filesystem: 

emc# sh .usr/epoch/et.c/roK/K60nial stop 

11. Restore die filesystem where die EDM software was 
installed (/usr/epocli/etc) out of place, and then move it to 
the proper location (/usr/epoch) to bring back die database 
files. Tlien reboot the migration client. 

12. If you have an EDM database client, reinstall the vendor 
database software, if needed, via dieir instructions. Ilien 
reinstall the Backup sofCw'are, if needed. For offline 
database backup and Oracle online backup, you can do this 
through die EDM Backup Configuration window. For eariier 
online backup clients, see the appropriate online backup 
supplement and release notes. 
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For Both Backup and HSM 
Clients 



After you reinstall the EDM Backup software using 
eb_install_cMeiit, you are ready actually to restore your files. 
13. Open the EDM Restore window: 



- from the client using; 



client 1# edmorestore 



or 



" from the EDM Main window. 
Use the EDM Restore window or ebcrecover to restore 
your lost filesystems and files, hi the EDM Restore window 
you can browse a list of work items for the client, select the 
work item, mark the files you want to restore, and start the 



restore. 



Reboot the client system. 
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Structure 



This appendix describes the directory' structure of EMC Data 
Manager backup, volume management, and HSM. 

This is tlie directory structure of the softvv'are that mns on a 
server and the software that runs on the client, which enables 
the client to collect backup data and restore recovered files. 

This appendix describes the following: 

• Backup Sei-ver Directory Structure 

• Backup Client Directoiy Structure 

• Volume Management Directory Slmcture 

• HSM Directoiy Structure 
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Backup Server Directory The EDM backup seiver software handles all aspects of backup 

Structure and restore operations. Its components are: 

» EDM transfer protocol or remote shell (rsh) - Communi- 
cation betw'een die server and client. Tlie EDM transfer 
protocol is supported on IMJX platforms. 

» EDM Backup server processes — Daemons and programs 
that service backup and restore operations. 

• The Global Configuration Database - Configuration 

specifications that direct backup and restore operations and 
files that manage tlie database. 

» The Installation Directoiy - Dii-ectory on the EDM server 
that contains backup installation and executable files for 
both the server and the client systems, lliis section 
describes backup by looking at the elements on the server 
that operate die backup and restore operations. 

EDM stores two sets of files on the server: large and small. 'Ilie 
set of large files (backup catalogs and log files) grows over time 
and the set of small files (cUenl binaries and configuration files) 
does not. 



/USr/epOCh The /usr/epoch di rectory includes several subdirectories that 

contain configuration and database files. 

CAUTION: Although these files are text files, you 

should never attempt to modify them with 
an ordinary editor. The configuration 
commands and the EDM Backup Configu- 
ration window do more than just modify 
the files. 

Figure A-1 shows many of the top-level directories. 
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Figure A-1 Server Directory Structure (/usr/epoch) 



/usr/epoch 



gui 



Internal 



locks 



sample 



adm - location for circular and archived log files 

bin - contains user executable binaries 

doc - contains online documentation 

etc - contains vital EDM software databases 

fifos - EDM softvv'are fifos 

gui - gui resource files 

install - contains non user executable install files 

interna] - contains EDM internal commands 

lib - contains shared libraries and non user executable 

daemons (linked to fi-om /usr/epoch/etc/lm) 

locks - contains lock files 

man - contains all man pages 

sample - contains sample Volume Manager and Library 

Manager configuration files 

tmp - EDM software tmp directory 
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/USr/epOCh/EB The next level of backup server directories, /usr/epoch/EB, 

contains the following subdirectories. 



Figure A-2 Server Directory Structure (/usr/epoch/EB) 




bin I I catalogs | I client config db locks log preconfig 



• bin - contains the server executables 

• catalogs - contains the backup catalogs and the saveset 
database (ebsaveset_db) 

» client - contains client executables and installation files 

• config - contains the configuration files, including eb.cfg 

• db - contains database files; for example, cattask.list and 
htab 

• locks - contains lock files: for example, ebcaialogd.lock 

• log - contains the backup log files 

• preconfig - contains a file for each client widi default 
configuration information 

When you initially configure backup using eb_server_coiilig, 
you can create the directory /usr/epoch/GENDIR/EB to hold 
large catalogs and log files. 
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If you run eb_server_conlig without the -D option, you are 
prompted to create the alternate directories. eb_server_config 
also creates the following symbolic links (symlinks): 

• /usr/epoch/EB/catalogs is a symlink to 
/usr/epoch/GENDIR/'EB/catalogs 

• /usr/epoch/EB/log is a symlink to 
/usr/epoch/GENDlR/EB/log 

Refer to the eb_server_conlig man page for more information. 



The bin directory contains all the server binaries and a 
VERSION file tliat contains the current version of EDM Backup 
software and a HISTORY file that contains a history of all EDM 
Backup installations. 



The bin Directory 



/usr/epoch/EB 




The catalogs director^' contains the saveset database and one 
directoiy for each configured work item. This subdirectoiy has 
the same name as the woi'k items and is created as neces.sary hy 
the catalog subsystem. Any "/" characters in the work item's 
name are translated to characters for use in directoiy and 
filenames. 
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Below the work item directory are DATE directories. DATE 
directories are named witli four-year digits followed by a dash 
and the month digits (for example, 1998-02). Hie catalog 
software must be able to create a date directory when it writes a 
new backup catalog. 

The puipose of this directory structure is to enable system 
administrators and customer support personnel to scan 
directories of moderate si2e for catalog files, while allowing the 
software a simple and fast algorithm for locating catalogs. 



Figure A-4 



The catalogs Directory 




work item 


1 work item | 


1 1 


1 date directory |~|^ 


1 date directory |" 



Client Directory The client directory contains binaries and other client platform- 

specific software. Undej- this directory are client platform 
directories of the form: 

manufacturer_cpu_o^i _other} 

The _other suffix is optional. It is used for anydiing that does 
not fit into the scheme of manufacturer, cpu, and OS. Normally, 
it is not used. Client platform directories have names such as 
sun_sun4_v5 or hp_800_vl0. 
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The client directory also contains a subdirectory called generic. 
This subdirectory (as well as each of the platform subdirec- 
tories) contains a bin subdirectoiy, which contains up to mo 
files that are used in customizing the client installation process. 
The file that is shipped as part of the backup software distri- 
bution package is named eb_ci_particulars. The second file is 
generated ixom tlie first and is named eb_ci_data. The following 
describes each file: 

• eb_ci_particu]ars file - Contains definitions set by EDM for 
constants that should not have to be changed at your site 
(such as tlie name of the platform-specific options to be 
used with the mntpts command). 

• eb_ci_data file - Contains the generic platform's constants. 
Tliis file is created during backup installation for each 
platform type under /usr/epoch/EB/client. 

Under each specific client platform director)' are the subdi- 
rectoiy, bin and optionally, the subdirectory man. Tlie bin 
directory contains all client scripts and binaries for installation 
of the client as well as those for the normal backup operation of 
the client. Like the bin subdirectory under generic, tliese bin 
directories may also contain the eb_ci_particulars file. In all 
cases this subdirectoiy contains tlie eb_ci_data file. 'Hie man 
directoiy contains man pages for the client recoveiy program(s). 
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Figure A-5 The client Directory 




Config Directory The config director contains the default eb.cfg configuration 

file, sample configuration files, and a sample findxcpio macro 
file, called defines. cfg. It also contains a file called 
clients_installed which is modified when each client is installed. 
It includes the mailok script to which tlie backup software 
passes backup completion reports, and the maOerr script to 
which it passes backup failure reports. 



Figure A-6 The config Directory 



/usr/epoch/EB 
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If you installed backup to backup all (or some) clients by using 
the autoconfig facility, this directory also contains a default 
configuration file for each such client (/config/cZ/e???- 
nmrie/dcfg), and an autoconfig. cfg file, 'lliis autoconfig.cfg file 
references tlie default (dcfg) file for each client, via an 
*INCLUDE, and provides a single work-group definition for the 
auto_configured_work _group. You can then create a template 
that references that work item and thus backs up all the 
autoconfigured clients at once. 



The db directory contains the EDM backup database files. 



The db Directory 



/usr/epoch/EB 




ci_ac is a subdirectory that contains information that is used 
by recover's graphical user interface. It stores information 
similar to that in the preconfig directory but is more timed 
toward graphical standards. 

ci_data is a subdirectory that stores die installation param- 
eters for each client machine. 'Iliese parameters describe 
what occurred during the most recent client installation. 
One file in tliis subdirectoiy exists for each machine 
installed, and it is named after die machine: 
/usr/epoch/EB/confi g/db/ci_data/c/ ient-na me . 
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« cm is a subdLrectory that contains all of the information tliat 
the coverage ]-eport uses. 

• caltask.list is ebcatalogd's database file. It contains all of 
the information that is needed to process the catalogs tliat 
ebbackup generates. 

• htab lists and identifies all of the installed clients. 

• todo.list is ebbackup's database file. It contains all of the 
backup history, including when the backups occurred, how 
long they took, the old and current schedules, etc. 

The following files exist only on an HSM system: 
® ebsb vol. list (the saveset-to-basellne relations file) is used for 
baseline backups (levels Bl and B2). For each physical 
volume that is used in a baseline backup, this database 
records the volume 113 and saveset 11) of die backup. 

• ebmtag.list maps work item names to EpochMigration tags. 



Locks Directory 



The locks directoiy contains lock files, for example, ebcat- 
alogd.lock and a lock file for each work item. This directoiy is 
flat; no subdirectories exist under locks. 



Log Directory 



The log directory (which may contain a symbolic link to 
/usr/epoch/GENDlR/EB/logs) contains all of the EDM backup 
logs files. For more inlbrmation on log files, see page 16-35. 



Preconfig Directory 



The preconfig directory contains a file for each client. This file 
contains default configuration information for die client. 



Server Man Directory 



The server man pages are installed in /usr/epoch /man , 

For a listing of both server and client man pages, see Chapter 18 
"Man Page Listing". 
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Table of Backup Server 
Directories and Files 


Table A-1 describes each of the seiner's configuration files. 


Table A-1 


The Server's Configuration Directory 


File or Directory Name 


Description 


/iisr/epoch/EB 


Contains tlie sereer's EB dii'ectories and files. 


/usr/epoch/ EB/bi n 


Contains tlie server's binaries. 


/usiy'epoch/EB/bin/VERSI O N 


Contains the current installed EDM backup version. 


/usr/epoclx/EB/bin/HlSTOI^Y 


Contains the EDM backup installation history. 


/usr/epocli/EB/catalogs 


May contain a symbolic link to the liackup catalog directoiy on tlie EDM 
backup seiver: /usr/epoch/GENDlIi''EB/catalogs 

This stores the Ixickup catalogs. 


/usr/epoch/EB/client 


Contains all client installation files. Contains a subdij-ectoiy for eacli 
platform manufacairer, CPU architecture, and OS revision supported for 
EDM backup clients. 


Aisr/epoclv'EB 

/dlem/maniif_cpiij3s 


Describes the platform manufacturer, CPU architecaire, and OS revision. 
Each subdii-ectory name is of the fomiat: manufacturer_cpu_os (e.g., 
sun_sun4_v5). 1'his directory is not used until tlie client installation 
procedure is performed. 


/iisr/epoch/EB 

/clianl/ man uf_cpu_os/hm 


Contains platfonn manufacturer client binaries. 


/iisr/epodVEB 

/client/OTfl«r4/lc/3i/_os/man 


Contains the client man pages. 


/usr/epocli/EB/client/generic/bin 


Contains binaries that are used to customize client installations. 


/usr/epoch/EB/config 


Contains the EDM backup configuration files, 


/usr/epoch/EB 

/config/auroconfig. cfg 


Contains information used by autoconfig to define the 
auto_configured_work_group, and to reference tire default configuration 
file for each autoconfig client. 


/usr/epocli/EB 

/corAg/ client--name/6dg 


Describes the configuration for each client that is ijacked up via the 
autoconfig facility. 
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The Server's Configuration Directory (Continued) 



File or Directory Name 



Description 



/usi-Zepocli/EB/ 

config/'cl ients J nsta 0 ed 

/usr/epoch/EB/'config/'defines.cfg 

/usr/epoch/HB/config/'maileiT 

/usr/epoch/EB/config/mailok 

/usr/epocli/EB/config/samples 

/usr/epoch/EB/config/el3.cfg 



/usr/epocli/EB 

/ coniig/loca Ldb_sta rtup 

/usr/epoch/£B 

/config/locaLdb_cleanup 

/usr/epoch/EB 

/'config/]ocaLdb_warning 

/usr/epoch/EB/db 

/usr/epoch/EB/db/ci_ac 

/usr/epoch/'EB/dlj/ci_data 

/usr/epoch/EB/db/cm 
/usr/epocli/EB/'db/ebmtag. li st 
/usr/epoch/EB/d IVtodo. list 

/usi"/epoch/EB/db/ebsbvo1 .1 ist 



Contains an entry for each EDM backup client instalJed. You can read Ixii 
not edit this file. 

Contains a sample findxcpio macro file. 

Contains the script to which the backup software passes backup failure 
reports. 

Contains the script to which the backup software passes backup 
completion reports. 



Contains sample configuration files ! 
the eb.cfg file. 



reference when editing 



Contains the sei-ver configuration file. You edit this file by way of the 
EDM Backup Configuration window to specih' the seiner's confisuration 
information. 

Dictates what gets backed up by the l.OCAL^D.A'fABASE backup. 

Dictates what happens after the LOCAL^DATABASE backup is done. 

Mails a warning message to the administrators if the LOCAL^^DAl ABASE 
backup is too old. 

Contains ebbackup's database files. 

Contains information used by the EDM Restore window. 

Stores the installation parameters desciibing what took place during the 
most recent installation of each client machine. 

Contains all the information used by the coverage report. 

Maps work item names to EDM Migration tags. 

Contains all the backup history (when backups occurred, how long they 
took, schedules, etc.). 

Stores the volume id(s) and save.set ID for each baseline backup. 
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Table A-1 


The Server's Configuration Directory (Continued) 


File or Directory Name 


Description 


Aisr/epocli/EB/db/cattask.list 


Contains all infonnation needed to process the catalogs generated by the 




backup softw'are. 


/usr/epoch/EB/] ocks 


Contains all of the temporaiy lociv flies that the backup software creates 


during backup and restore operations. This includes locks on templates 




and trailsets. 


/usr/epoch, EB/log 






seiver: /usr/epocli/GENDIR/EB4ogs 




Stores the server log files. 


/usr/epoch/EB/preconfig 


Contains a file for each client; each file contains default configuration 




information for the client. 


/usr/epoch/'man 


Contains the man and cat directories for the man pages. 


D(fl«n.ll|J UIICII& UlfCwllll^ 


All backup files on the backup client are stored in the baclcup 


Structure 


client's home directory. 




The examples in tliis document specify tlie name of tlie default 




user, ebadmin. The home directory is specified as -ebadmin. 




Note: For security purposes, ebadmin should not have a 




password, and a user should not be able to log in. 




file backup software creates the default user name 




with no password. (Refer to "Security Issues" 




below.) 



Client HoniB Directory The goal of the client installation procedure is to set up the 

backup client home directory as shown ItcIow. Assuming that 
you used the default backup client username ebadmin, the 
home directory is -ebadmin. You can have a separate backup 
client home directoiy on each client system or you can specif}' 
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one directory that all the clients mount via NFS. The directoiy 
sti-ucture allows this type of sharing, althougli it does not allow 
one client to be backed up by multiple EDM units. 



Figure A-8 The -ebadmin Directory 



~ebadmin 




Under the home directoiy there is a subdirectoiy for each client, 
named with the client's network host name. The client directory 
contains the bin directoiy which holds all the client binaries as 
well as a VERSION directoiy that displays the versions of the 
binaries. The client directoiy also contains the backups and 
recoveries log files (for more information, see "Log Files" on 
page 16-35) and a HISTORY file tliat displays eacli client instal- 

In the case wdiere many clients share the same platfomi and OS 
release, installing binaries in each client's home directoiy is 
redundant. ITius, you can replace a bin directory with a 
symbolic link to a bin directory of another client of the same 
type. You must do this manually (it is not done during instal- 
lation). 

If you reinstall or deinstall a client, the existing bin directory is 
removed. Thus, any clients that have links to that directoiy are 
not backed up. 
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Security Issues a potential security hole exists for backup client directories diat 

are shared via NFS by more than one client. For example, 
consider two clients, clientl and client2, tliat share the same 
backup client home dii-ectoiy. Call the backup client user 
ebadmin and this home director^' -ebadmin. In this case, 
someone who is logged in as root on clientl can go into the 
-ebadmin directory on clientl and change its .rhosts file to 
allow access to tlie directoiy as ebadmin from clientl (normally 
access is only allowed from the EDM). He or she can then 
contact client2 as ebadmin from clientl and cause client2 to 
perform backups of any file on client2 and send the output to 
client!. Furthermore, the bacloip data can then be manipulated 
on clientl and sent back to client2 as a restore so as to 
overwrite existing files on client2. 

Note: If this type of security is of concern to you, do not 
share client backup liome directories via NFS. 



Additional Client Software The default location for -ebadmin is 

/usr/epoch/EB/CLlEN1LHOME. 

Some of tlte other client directoiles are listed in Figure A-9. 



Figure A-9 Client Directory Structure 




I CLIENT_HOME | 
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EB - contains tlie client home directory (-ebadn: 

EB_DB - holds database backups 

bin - contains repon and restore scripts 

man - contains client man pages 



Client EB_DB Directory 



Each installed client gets the /usr/epoc!i/EB_DB directoiy 
which holds database backups. 



Client bin Directory 



You can also install scripts on selected clients for client file self- 
recoveiy and report generation. By default, tlie scripts are 
installed in /'usr/epoch/bin. You can also install the scripts in an 
alternate directoiy. 



Figure A-10 



The Client bin Directory 




Client man Dir^tory You can choo.se to in.stall the client man pages in either 

/usr/epoch/man, /usr/local/man, or in a location of your 
choice. 

For a listing of both sen'er and client man pages, see Chapter 18 
"Man Page Listing". 
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Table of Backup Client Table A-2 describes tliese client files and directories. 

Directories and Files 


Table A-2 Client Directories 


File or Directory Name 


Description 


-ebadniin t/usr/epoch/EB/CLlENTlMOME) 


Default client home dii-ecioiy that contains a subdirectory For each 
client, named with the client network liost name. 


-chad mm/ client -im me/H n 


All client binaries for die client are stored here together with a 
VERSION dii-ectoiy showing the vej'sion of these binaries. 

The bin subdirecloiy can be a symbolic link to the bin subdi- 
rectoiy of another client with the same architecture and OS. 


~ebadmin/"'c//CT7^-na?He'li]S'l'ORY 


HISTORY file shows each installation that is performed for the 


-ebaci mi n/clien f-wa???e''backu ps. log 


Client's backups.log file records critical information about backups 


~ebadmiiv'c//CT#-7;a?ne/backups.log.ciTiinfo 


Contains coverage monitor data that is sent to the sen'er after each 
backup. 


~ebadmin/c//e«^n(i???e/i-ecoveries.log 


Client's recoveries, log file records information about file i^estores 
that are performed on this client. 


~ebadmin/c//f^w?-«.flme/'eb_ci_data 


Contains shell script values that are required by various shell 
scripts such as start fmd. 


/usr/epocli/man or /usr/local/man (or 
an alternate directory) 


Contains the client's man pages. 


/usr/epoclv'bin/ebcreport 


Enables networked clients to produce reports such as media and 
backup history reports. (See man page.) 


/usr/epoch./l3in/ebcrecover 


Allows a networked client to restore files, directories, and 
filesy stems. (See man page.) 


/usr/epoch/bia/edmcrestoj-e 


Starts the EMC Data Manager Restore window from a netwoj-ked 
client. 


/usr/epoch/EB_DB 


Contains files for backups of database files. 
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VolUrnB MSnSyBITIBnt The /usr/epoch/etc directory has many subdirectories that 

Directory Structure contain vital edm softw are database files. Two of tliese are the 

Library Manager and Volume Manager files. Figure A-1 1 shows 
these two subdirectories of /usr/epoch/etc. 



Figure A-1 1 



/usr/epoch/etc Directory 



I Im name I 
I /m name \ 
I lm_name | 



Library Manager Each Libra ry Manager resides in an individual subdirectoiy in 

Subdirectories /usr/epoch/etc/lm. For more information, see "Library Manager 

Configuration Files" on page C-9. The directoiy name matches 
the Library Manager name that appears in the Display area of 
the main volume management window. 

Within each Library Manager directoiy, Imconfig creates 
several files. During start-up, the Library Manager reads the files 
in its directory to initialize the library unit it is managing and to 
set up its internal data structures. Table A-3 describes the files 
that are located in each of the Library Manager directories. 
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Files in /usr/epoch/etc/lm//m_nanie 



Description 



Im.cfg Configuration file for the Lil^raiy Manager. Libraiy Manager configuration includes param- 

eters that define the hardware address (SCSI bus, target IT), and lun) of the device, Library 
Manager name, number of drives, and scheduling parameters for the robot and drive(s). 
See "Library Manager Configuration Files" on page C-9- 

volid.dat Inventory list of the libraiy unit's contents. This file enables the Library Manager to start up 

without taking a complete inventoiy of the library unit. If volid.dat does not exist, the 
Library Manager inventories the lilirary unit and creates the file. 'Hie Libraiy Manager 
updates the volid.dat file when it: 

• writes a label to a volume 

• moves a volume into or out of an inlet, slot, or drive 

• enables or disables a librar)' unit slot 

• takes an inventoiy of the libraiy unit 

d» Soft link to the physical name of the drive that is located in /devices, n indicates ttie drive 

number. 

lm_in_drive_n.dat Drive contents file for each drive installed in the library unit; where n indicates tlic drive 
number. 

clog Circular log file that contains a detailed desciiption of the activity for this Library Manager. 

Imd Link to the Libraiy Manager executable daemon located in /usr/epoch/lib/'n'm. 

liblmjnumber Contains a number used internally to identify the Libraiy Manager, 

lm_is_open Lock file that ensures that only one copy of [he Libraiy Manager daemon is ninning at one 

time. 
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Volume Manager Files 



Hie directory /Lisr/epoch/etc/vm contains all files that are 
related to die Volume Manager. For more information, see 
"Volume Manager Configuration File" on page C-2. Table A-4' 
describes the files tliat are contained in /usr/epoch/etc/vm. 



Files in /usr/epoch/etc/vm 



File Name 

clog 

notd 
notd.pid 

notd_c]og 



Description 

Nolumc Managei daemon's circular log (clog) file. An ascii file that seizes as 
a debug log and contains a detailed description of the vmdaeitKMVs acti\it\. 

Link to ihi- notif\ daemon located in /usr epoch -lib Tvm. 

Xoiih daemon's proLCss 11) file. 

\otih daemon's circular log (clog) file. An ascii file that stives as a debug 
log lor the noiih deamon. it contains a detailed description ol tlu- nold's 



templates 
templates. del' 
templates.temp1ateid.ndx 
vm.cfg 



vmerd 

volumes 
volumes, def 
volumes. volid.ndx 



Template catalog contains volume templates for labeling media. 
Template record definition file, 
'template index file. 

Volume Manager configuration file. This file contains parameters that define 
the location oF the vmdacmon, set the message-logging level, and lists the 
Library Managers configured for this servei'. See '"Volume Manager Configu- 
ration File" on page C-2. 

Lock file which prevents two Volume Manager daemons from running at one 

Link to the Volume Manager executable daemon that is located in 
/usr/epoch/bin. 

Link to the Volume Manager's erasing daemon that is located in 
/usr/epoch/1 ih/ rvm . 

Volume catalog, contains complete volume information for the ser\'er. 
Template catalog contains volume templates for labeling media. 
Template index file: an internal file used exclusively by the vmdaemon. 
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HSM Directory Structure The /usr/epocli/etc/mal directory includes several subdirec- 
tories which contain server and client configuration and 
database files. 'Ill is section provides detailed information on this 
directoiy strucaire. 



HSM Configuration Database Ever\' edm hsm server and eveiy migration client contains a 
migration configuration database. Tliis database consists of 
structured text files tliat are updated by the emstconf, 
emfsconf, and emsysconf commands and by the functions 
you perfomi when using the EDM HSM Configuration window. 

The database contains information that specifies which 
filesystems are stageable, when files should be staged, and the 
staging templates to which filesystems are assigned. 

CAUTION: Although these files are text files, you 

should never attempt to modify them with 
an ordinary editor. The configuration 
commands and the EDM Backup Configu- 
ration window do more than just modify 
the files; they also know how to internet 
correctly with any st£^ing processes that 
are running. 

On client systems, tlie database also lists the fileserver and store 
to which staging templates are assigned. 

The text files are stored in the /usr/epocli/etc/mal/ directoiy. 
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Figure A-12 



Configuration Database 




'I'able A-5 lists the database filef 



Table A-5 




Migration Database Files 


Argument 


Description 





Text file that contains system-wide configuration data, You update this file with the 
emsysconf command or when you change global properties with the Configuration 
Interface. 

■J'ext file that contains staging template configuration data. You update this file mith the 
emstconf command oi- when you change staging template information with lite 
Configuration Interface, 

Text file that contains client store information. You update this file with the emstcojif 
command or when you change store infonnation with the Configuration Interface. 

Text file that contains per-filesystem configuration data. You update this file when you 
issue the emfsconf command or when you change filesystem infomiation with the 
Configuration Interface, 



'lext file that contains baseline backup inform 
software on behalf of the backup software. 



. This data is manipulated by the HSM 



Network HSM Server Database The nerw-ork migration server has a global configuration 

database that contains information about network migration 
activity^ and the default client store values. 'Ilie global configu- 
ration database files reside in /usr/epoch/etc/mal. 

CAUTION: Editing these files directly may result in loss 
of data. 
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Although both the emsd_conf_db and the emsd_store_db files 
contain editable text descriptions of the configuration, do not 
edit these files directly. Instead use the seiver's configuration 
commands or the EDM Backup Configuration window to make 
any modifications to die database. There are five database files. 



Figure A-13 


Global Database Files 






1 /usr/epoch/etc/mal | 




(^msd_ 




stats^J) (T emsd_data ^ 


Table A-6 


Global Database Files 




File 


Description 




emsd_conf_dl3 


I'ext file that defines the limits on the HSM software protocol 


requests and the defauk 




values fo]- client store configurations. 


emsd_inro 


Binary' file that contains information about the cun-ently execi 


iting emsd process. 


emsd_store_dl3 


Text file with a list of configured client stores and their locatic 






Binaiy file that contains cumulative statistics on HSM software 


protocol tiaffic and client 




agent activity. 




emsd_data 


Binar\' file that contains the HSM usage histoiy on the seiver. 





Client StOrSS Each client store has its own file hierarchy and is logically 

independent from eveiy other client store. ITie client store's 
top-level directoty contains three files and two subdirectories. 

As system administrator you see these files and directories when 
you list tlie contents of the client store directoiy. 



EDM Software Reference 



A-24 



Directory Structure 



Figure A-14 Client Store Organization 




The client store's top-level files and directories ai'e listed in 
Table A-7. 



Table A-7 




Client Store Files and Directories 


File/Directory 


Description 




store^conLdb 


Text file of the stc 


3re"s configuration information. 


store_state_db 


Text file of the stc 


ite's state information that the client agent keeps current. 


recover_list 


List of the Ixrfiles 


to restore from the EDM server's [backups. 



new^liitfiles 'femporaiy liolding directory for bitfiles that are Lieing created as part of a stage out from 

a client system. 

bitfiles r_)i]'ector>' that contains the completed l3itfiles in a 3-level hierarcliy. 

When the client agent creates a bitfile, it gives the bitfile a 16- 
digit hexadecimal name and places it in the new_biifi1es 
directory. ITie bitfile remains there until it is completely written. 
Once the bitfile is complete, the client agent moves it to the 
bitfiles directory. 
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Bitfiles Bitfiles reside at the bottom layer of a directoiy liierarchy as 

shown in Figure A-15. Bitfile names are l6-digit hexadecimal 
numbers representing the lower 64-bits of a file's bilfile ID. Cllie 
bitfile ID consists of the bitfile name plus the store ID.) 
Migration uses this organization so that a bitfile can be located 
by using the hexadecimal encoding of the bitfile ID. 



Figure A-15 Bitfile Hierarchy 




C^ SFS 1 78 AOO0 1 010 0^ • ■ • C^lyiySAOOOIoTFr^ 
Maximum of 2563 = 16M bitfiles 
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Configuration 
File 



The backup configuration file (/usr/epoch/EB/config/'eb.cfg) on 
the EDM Backup server defines how backups run at your site. 
The configuration interface stores its data in tlie eb.cfg file. 

You configure your EDM backups using the Backup Configu- 
ration wizard, and you tailor your configurations to your needs 
by using the EDM Backup Configuration window. (Avoid 
manually editing the configuration file.) When you do not have 
access to tlie graphical interface (such as when dialing in), you 
can use the interactive command line interface, eb_config. 



WARNING: Manually editing the eb.cfg file risks 
corrapting the backup configuration. 



This chapter desaibes die statements within the configuration 
file. These statements correspond to windows and fields in the 
EDM Backup Configuration wizard and window, but they do 
not match exactly in wording or in number. Tliis chapter does 
not decribe Symmetrix Patli, Symmetrix Connect, or new 
database clients. 
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EDM Backup Configuration File 

The topics in this chapter include: 

» General Coding Rules 

• Summaiy of Fields 

• Server Fields 

• Work Group Fields 

• Filesystem Work Item Fields 

• Database Work Item Fields 
» PC Work Item Fields 

» Backup Trailsets 



OSnSrSf Coding RUISS ir you must edit the configuration file, follow these general 

editing rules: 

Note: Tire EDM Backup Configuration window reformats 
the eb.cfg file. If you edit eb.cfg directly, you lose 
comments and spacing the next time you mn the 
interface. The EDiVI Backup Configuration window- 
reads in C pre -processor #include statements. 

• The configuration file is made up of nested sets of blocks; a 
set of curly braces { {...}) delimits each block, Make .sure to 
use these braces in pairs. For each open brace, tiiere must 
be a closing brace. 

" If you include multiple conflicting specifications for any 
given field, tlie last specification is used in most situations, 
unless otherwise noted in tliis chapter. 

• U.se a .semicolon (;) to tenninate entries that do not begin 
with a brace: 

work group list: "dave' s group" , "tony' s group"; 

• Separate multiple strings by using a comma and optional 
spaces: 

authorized backup list: "cadi", "cad2", "cad3", 
"atlas2"; 

» Do not use the line-continuation character C\). 
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Any comments are delimited using paired slasli-asterisk 
characters: /''comments*/ . Comments should not span lines. 
Place double quotes around strings, where a string is any 
non-numeric value except tlie i-eserved words that are 
described in the next bullet, 
client backup username: "ebadmin"; 

Each quoted string must be complete on a single line: 
strings cannot span lines. Make sure to specify each string 
by using tlie coirect case (capitalization). EDM Backup is 
case-sensitive when inteipreting strings. 

Some reserved words do not require quotes; you can enter 
them as follows: 

- Always use the standard three-character abbreviation 
when specifying a month. Use all lowercase characters, 
or uppercase the first character only (for example, mar 
or AMr). 

- Specify units of time as hours, minutes, seconds, days, 
weeks, etc., as described for each field. Always use 
lowercase characters when specifying units of time. 

- Spell out days of the week completely. Use all 
lowercase characters, or uppercase the first character 
only (for example, sunday or Sunday). 

Specify units of computer storage as follcjws: KB or K; 
MB or M; or GB or G (lowercase or upperca.se). 



Checking Your Changes if you do edit the configuration file, you always must check 

afterward for syntax errors. To do this, run ebbackup with 
the -check option, lliis causes ebbackup to report any syntax 



1 , Under certain unusual condi Lions, some sy,stax errors will not be detected 
until the actual backup is am. 
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As necessary, edit the file to con-ect the errors, and then run tlie 
check again. Repeat this process until no more errors are 
present. 



When Changes Take Effect when you change various configuration parameters, changes 

eitlier: 

• take effect immediately on your system (even as backups 
are being processed), or 

• take effect tlie next time ebbackup processing is started, 
eitlier from an entry in root's crontab file or by issuing the 
ebbackup command manually 

This does not include the next time ebbackup autoscheduling- 
only (-sched option) or checking (-check option) is started. 
Any exceptions are noted in the discussions. 



Summary of Fields Table 13-1 .summarizes the fields in the co3ifiguration file. It 

includes a brief description of each field, tlien tells whether the 
field is required (Req column), the field lengtli and range of 
possible values, the initial value at installation, and when a 
change to the field takes effect. 
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The fields are presented generally in the order that they appear 
in the file. 



Table B-1 Summary of Fields in the Configuration File 



Field 


Description 


Req 


Size or Values 


Initial Setting 


Takes 
Now 


Effect 

Next 
Bkup 


Sei-ver Blotic Fields 


eliserver 


Name of the EDM Backup 


yes 


1 -63 char 


seiver-name 






client backup 
usemame 


Login name used when 
ebbackup connects with client 

system 




1-63 char 


ebadmin 




✓ 


bacl<up 

adininistraior 

usemames 


Individuals who are responsible 
for EDM Backup, and who have 
root-like privileges within the 
EDM Backup environment 


yes 


1-63 char 
(per user) 


root 


✓ 




authorized 
Iiackup list 


Client systems that are backed 
up l>y the 1-DM Backup sei'ver 


yes 


1-63 char 
(per client) 




✓ 




autliorized 
recoveiy list 


Users who can restore files 
backed up from their own client 
(known as a self -sen 'ice restore) 




client-.usei' 
combinations 


none 


restore 




authorized cross 
recover^' list 


Users who can restore files to 
clients other than those from 
which the backup files origi- 
nated 


no 


clienP.itser 
combinations 


none 






recovery 
administrator list 


Users who can restore files 
other than their own to the 
client from which the files were 
originally backed up 


no 


clienP.user 
combinations 




next 




maximum 

simultaneous 

clients 


Global maximum 
number of clients that are 
backed up concurrently across 
all trails 


yes 


in the range 1-64 


24 


✓ 
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Summary of Fields in the Configuration File (Continued) 



Description 



Req Size or Values Initial Setting Takes Effect 



Now Next 

Bkup 



trails cnncur- 
reniK 



It throughpu 



Maximum numlx-r c 
Backup can \\ rite K 
type of media cunc unciiil 

'Ibtal througliput of iiacki 
processing 



trails 1;D,M 
a specific 



iinii K per li(Hir 
mm K per minute 
nnii K per second 
(A' is KH, MB, or 
GB) 



4 per type of 
device 



600KB p 



maxiimin! seiA c^r 
iyackups.log file backiips.log file 



iDin K or no limit 
I A' is KB, MB. or 



maximum ser\ c 
rcco\erics.log 
flic size 



A' or no limit 
iS KB, MB. oi 



n client Maximum size of each 
backiips.log file client's backups.log file 



dog tile 



maximum client Maximum s 
recoveries.log client's recc 
file size 



catalog threshold Lcnx-l 0 backup is forced for any 
to force level o files\-stein work item when 
backup more than this number of files 



iviii K or no limit 
CA' is KB. MB. or 
GB) 

mm K or no limit 
iK is KB, Mil or 

GB) 

number of files: 0 
disables this leattire 



next backup 
for the client 



next backup 
for the client 



Work Group Field 



Name of the work group 



-£ System Work Item I'ields 
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Summary of Fields in the Configuration File (Continued) 



Description 



Size or Values Initial Setting Takes Effect 



Now Next 

Bkup 



Name of the work item, the 
client backed up by the work 
item 

Name of one or more 
client directories, filesystems, oi 
files that receives level 0-9 
backups via this work item 



baseline filespec Same as above, but lists those no 
local-client directories and 
filesystems in I ISM systems that 
receive a baseline backup 



migration backup Tag usee 
tag referenci 



migration store on 
the server with the migration- 
client files from which the stor 
was created (applicable when 
backing up staged files f 



1-63 char (each, per none 
work item &- client 
name) 

pathnames and none 

optional 

ftndxcpio 

qualifiers (no 
size limit) 

same as filespec none 



1-63 char; first 16 none 
must be unique 



the 



.Marker that identifies work : 
items that should not be backed 
up concunently 

Specifies the use of an alternate : 
network pon for a work item in 
a multiple networked client. 

Pi'iority at which tlie work item 
should nin 

Statement used to exclude the 
work item from load balancing 
(so no extra level-0 backups are 
taken) 



alternate pon name, 
must be a valid 
client name 



EDM Software Reference 



EDM Backup Configuration File 



Summary of Fields in the Configuration File (Continued) 



Req Size or Values Initial Setting Takes Effect 



Now Next 
Bkup 



not backed up 
before forcing 
full backup 



Code used to limit the nun 
of files ior s\liidi the data 
portion is wiiiten to the Ira 
media (applicable tor files 
imder migration control, tt 
a\'oid performing e\cessi\i 
backups) 



Mapping between backup 
levels that 

normally occur (liased on the 
template used) and the level 
you want for this work item 

Level 0 backup is forced for the 
filesystem work item when 
more than this number of files 
in the w-ork item have never 
been backed up 



all files 

resident files only 

files not backed up 
in migration store 

non-baselined files 
only 

example: 

"Bx0xxxxxxxx9" 



number of files; ( 
disables this feati 



"BxOl 23456789" 



Database Work Item Fields 
These "Database Work Items" pertain 
and are included here to support rest 
supported for backup. 



3 the "offline database backup" flmctionality supported prior to EDM 4 
res only. They do not apply to the database backup clients currently 





Name of the work item, the yes 


1-63 char (each, per none 


✓ 




client backed up by the work 


work item & client 








name) 




filespec 


Name of one or more yes 


pathnames and none 


✓ 




client directories, filesy stems, or 


optional 






files that receives level 0-9 


findxcpio 






backups via this work item 


qualifiers (no 








size limit) 




database type 


Type of database to be shut yes 


oracle, informtx, none 


✓ 




down 


Sybase 
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Summary of Fields in the Configuration File (Continued) 



Description 



Req Size or Values Initial Setting Takes Effect 



Now Next 
Bkup 



datalaase sen'ei' 



database name 



Name of the database s 
the work item 



Name of databaseCs) found 
during configuration 



for yes server name 
yes database names 



Type of work item 

Defines the TCP/IP port on 
which tile client is 
listening tor a command from 
the EDM Backup servei-. Do nc 
use for kicker woi-k items 



yes coordinated 
yes socket®jtio/t 



backup client 

command 

backup client 

cleanup 

command 

backup client 
data buffer size 

backup server 
data buffer size 

recovery client 
data buffer size 



Script to be 



1 the die 



Script to be mn on the client 
after restart 



ye; 



Data buffei 
servers 



coordinated 

socker©0 



See "Database m^rk 
Item Fields" on page 
B-50 

See "Database \Xtork 
Item Fields" on page 
B-50 



client and yes 0-32 MB 
yes 0-32 MB 



0 MB 



yes 0-32 MB 0 MB 

yes 0-32 MB 0 MB 



PC Work Item Fi 
These fields are 
In several cases 



used for all PC clients: NetWare, Windows NT, and OS/2 and for OpenVMS Client 
the word netware is embedded in the code, but the field is used for all PC clients 
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Table B-1 Summary of Fields In the Configuration File (Continued) 



Field 


Description 


Req 


Size or Values 


Initial Setting 


Takes Effect 
Now Next 




Name o( the s\()rk llein. ihe 
client hacked up h> ihe work 
item 




1-63 char (each, per 
work item & client 


none 


✓ 


filespec 


Name of one cji more 
client directories, filesystems. <„ 
files that receives knel 0-9 
backups via this uork item 


yes 


pathnames and 

optional 

findxcpio 

cuialifiers (no 


none 


✓ 


exclusion tag 


ensures singie-tlireaded 
processing lor the dient. 
Re(|uired"and automatically 
generated for DOS. 


no 




none 


✓ 


method 


Defines the 'I'CP.'IP p<m on 
which the client is 
listening lor a tonuiuincl trom 
the n).\l Backup server 


ves 


nets\are@/JfjrC 
(see ""Connection 
Method" on page 

B-S7) 


for NetWare 

netware® 1492 
for OS/2, 

netvvare®3895 
for Windows N'f 

netware® 3896 
for Open VMS 


✓ 


netAvare 
usemame 


Determines what user privilege 
can execute backups and 


yes 


1-63 chars 

(for NT: i"nax 20 

characters) 


none 


✓ 


enci'ypted 
password 


Encrypted password for 
netware username 


yes 


not editable directly. 
Enter from EDM 
Backup Configu- 
ration window 




✓ 


netware client 
TSA 


Assigns a target seivice agent to 
the PC server 


yes 


servername 
.1-lleSystem 
(.local for OS2) 


none 


✓ 
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Table B 


;-1 


Summary of Fields in the Configuration File (Continued) 


Field 


Description 


Req Size or Values Initial Setting 


Takes Effect 

Now Next 
Bkup 


nem'are 
target 


client Defines the PC client £ 
in need of seivice 


IS a target yes client name none 


✓ 


Backup 


Trailset (Media Set) Fields 







backup trailset 
use trail 



Name of the trailset yes 

Name and type of media used yes 
for the trail, level of backups 
written to the trail, and the 
maximum number of work 
items that can be backed up 
concurrently to this trail 

Level of baseline backup no 
; written to this trail set (appli- 
cable with backups of HSM 
systems that are scheduled 
automatically) 



keep backups Retention period for the backup no 
media, qualified by level (0-9) 



keep baclaip 
catalogs 



Retention period for Isackup i 
catalogs, qualified by level (0--9) 



Retention period for saveset 
records, qualified by level (0-9, 
B1 , Wl) 



1-63 char 
name: 1-11 char 
type: mediajype 
level: 0-9, B1,B2 
max clients: 1-24 



nn months 
or forever 

{months is seconds, 
days, weeks, 
months, or years) 

same as for keep 
backups 

same as foj' keep 
backups 



backup catalog Backup level at whicli EDM 
delta level Backup should 

consolidate catalogs 



primary 

none 

media^rype 
none 



r (lev 0) 
nos (lev 1-9) 



1 yr (lev 0) 
3mos(lev1- 
1 yi- (lev 0) 



3 n 



s (lex 



next time 
scheduling 
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Table B-1 Summary of Fields in the Configuration File (Continued) 



Field 


Description 


Req 


Size or Values 


Initial Setting 


Takes Effect 

Now Next 
Bkup 


duplicate media 
after backup on 
..copies 


Automatic media 
duplication 










activation of 
media dupli- 


Manual media duplication 








✓ 


ap pen ding to 
copy 


Append to current duplicate 
media for media duplication, as 
opposed to use new media. 


no 






✓ 


using new media 
at each dupli- 


Use ne%v media for each dupli- 


no 






✓ 


Baclujp Schedule Template I'ields 


backup 
template 


Name of the schedule template 




1-63 char 


default 


✓ 


work group list 


Work groups that are backed up 
using this schedule template 


yes 


1-63 char (per work 
group) 


none 


✓ 


begin trailsel 
rotations on 


Date in tliture when EDIM 
Backup should .start using the 
trailset 


yes 


dd-mmm-yy 
mm/dd/yy 
mmm dd, yy 
mmm dd, yyyy 


date 

template is 
added 


next time 
sciteduling 

OCCUl'S 


rotation period 


Period of time during which 

least one 
level-0 backup 


yes 


nn days 

(days is days, 
weeks, months, or 
yeare) 


\i days 


scheduling 
occurs 
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Table B-1 Summary of Fields in the Configuration File (Continued) 



Field 


Description 


Req 


Size or Values 


Initial Setting 


Takes Effect 

Now Next 
Bkup 




backups are 

written for all the work groups 
backed up using this template 










alternate trailset 


Name of the trailset used to 
provide an optional, second set 
of backups on alternating nights 
(generally only used with 
automatic 
scheduling) 


no 


1-63 char 


none 


✓ 


logging level 


Level of logging messages 
written to the file 
specified via the server log file 
field 


yes 


stats debug 
per file 


stats 


✓ 


seiver log file 


Name and maximum size of the 
template's log file (stored on the 
server as /usr/epoch/liB/log/ 
filename) 


no 


pathname & file siz 

size: mm K or no 
limit 

(A' is KI3, MB, or 
GB) 


e default_ 
template.log 

256KB 


✓ 


back'up 

completion script 


Name of the script file used to 
store or mail backup 
completion reports 


no 


pathname 


mailok 


✓ 


backup failure 
script 


Name of the script file used to 
store or mail backup failure 
reports 




pathname 




✓ 


do all baseline 

backups before 
normal backups 


Statement used to force all 
scheduled baseline backups to 
finish before any level 0-9 
backups start for the template 




as stated 


statement 
omitted (don't 
force baselines 
first) 


✓ 
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Summary of Fields in the Configuration File (Continued) 



Description 



Req Size or Values Initial Setting Takes Effect 



Now Next 
Bkup 



recreate base! in 
if needed 



schedule 
standard 
rotations 



schedule 
lull during 

weekends 



files automatic 



of a staged-c 



illv, if the 
y is used in place 
ut copy during 

Statement used to turn on 
automatir schetluling, and to 
schedule some ponion oi the 
clients l(jr a lull backup each 
day tcannot be specified with 
/;/// during weekends rotations 

Statement used to tui'ii on 
automatic scheduling, and t(3 
schedule all lull backups <m 
Saturdays and Sundays (cannol 
be specified with standard 
rotations) 



;ekday backup 



weekend backup 
shift 



DM 



Target amount ( 
Backup shoukl run each 
weekday ( ,\k)nday-lTida\ : 
applicable with automatic 
scheduling to prcn ide a 
guideline) 

Target amount of time 1T)M 
Backup should run each 
weekend day ( Saturday-Sunday ; 
applicable with automatic 
scheduling to provide a 
guideline i 



no hh hours 



in the range 1 -24 
hours 



hh hours 
mm minutes 



in the range 1-24 
houre 



next time 
scheduling 

occurs 
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Table B-1 Summary of Fields In the Configuration File (Continued) 



Field Description Req Size or Values Initial Setting Takes Effect 



Now Next 
Bkup 



[for u'ork group] StatemenT(s) used to airn on 


no work grp: 1-63 char none 


next time 


custom scheduling, and to 


level: 0-9. Bl. 


scheduling 
occurs 


level 11 on ... specify when to run the 


backups for each level. 


orm 




optionally qualified by work 


on: days 

{days is a number [1 
or greater! within 
tlie rotation, as in 1, 
3-7; or the actual 
days, as in Monday, 
Tuesday, 2nd 
Monday) 




group 





Startup Pai-ameters 



perform initial 


Statement used to no as stated 


statement 




full backup on 


perform the initial full backup 


enabled 


scheduling 


scheduled day 


on some portion of all newly 






iastalled 








clients each day during the finst 








rotation period (applicable with 








automatic scheduling) 






perform initial 


Statement used to iiin the initial no as stated 


statement 


next time 


full backup as 


full backup on all newly- 


enabled 


scheduling 


soon as possible 


installed clients during the first 




occurs 




backup run after those clients 








are installed (applicable with 








automatic scheduling, and 








suggested if all new clients 








should receive a full backup as 








soon as possible) 
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Sorver FiBldS The seiver fields apply to all backup and restore operations that 

the server performs. Tlie seiver block looks similar to the 
following; 



ebserver: "atlasl" 
{ 

client backup username: "ebadmin" ; 

backup adininistrator usernames: "root", "jan", 

"tracy" ; 

authorized backup list: "cadi", "cad2", "cad3" 
"cad4", "cad5", "cad6", "docl", "doc2", 
"filserverl", "atlasl"; 



authorized recovery list: 
"cad3:eric", "cad4;jane", 
"docl:mary", "doc2 ; dave" ; 



"cadl:pat", "cad2:ken", 
"cad5 : torn" , "cad6:bob", 



authorized cross recovery list: "cadi : pat<cad4 " , 
"cad2 : ken<cad6" ; 

recovery administrator list: "*:jane", "cad2:ken" 

maximum simultaneous clients: 4 ; 

use at most 2 dlt trails concurrently; 

limit throughput to: 600k per second; 

maximum server backups.log file size: 256k; 
m^aximum server recoveries.log file size: 256k; 
maximum client backups.log file size: 64k; 
maximum client recoveries.log file size: no limit 
catalog threshold to force level 0: 0; 



} 

The fields are described in order as shown above. 
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ebserver This field specifies tlie name of the backup seiver, and defaults 

coirectly when die server is configured at installation (with die 
eb_server_conlig command): 



Client Backup USername use this field to specif^' the l- to 64-character login name that 

ebbackup uses when it connects with client systems: 

client backup username: "ebadmin"; 

Always use the installation default, ebadmin; this non-root user 
name is installed in /etc/password (or the NIS password map) 
for every client and server. 

CAUTION: The ebadmin user name must have /bin/sh 
as its shell. Using any other shell causes 
Installation and/or backup failures. 

If tlie default conflicts vv-ith another login name on your 
network, use an account that is dedicated to doing backups. It 
must be common to the seiver and all clients, and it cannot be a 
regular user name. 

If your site is j-unning more than one server, specify the same 
login name in the configuration file for each ser\'er. 

CAUTION: If you change the client backup username, 
you must reinstall the client software on 
every client, including the local client on 
the server. 

Changes to tliis field take effect the next time ebbackup 
processing runs. 



Backup Administrator use this field to identify individuals who are responsible for 

Usernames edm Backup: 

"tracy"; 
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You can specify any number of UNIX usemames (1 to 64 
characters each, and set to "root" at installation). Each usei* 
whom you specify has root-like privileges within the EDM 
Backup environment. 

The backup administrators can mn backups and restore files 
from any client system, browse any backup catalog (regardless 
of restore permissions), perform cross-restores to restore any 
data to any client, and so on. 

Note: Backup administrators do not necessarily need root 
access across the entire ser\'er s}''stem. 

Repeat this field as many times as you want to add usernames. 
At a minimum, specify one name. Changes to this field take 
effect immediately. 



AiUthorized Backup List use this Hst to identify tlnose clients (workstations, fileservers, or 

backup or migration sei-ver) whose files ciUi be backed up by 
this backup sePi'er; 

authorized backup list: "cadi", "cad2", "cad3", 
"cad4", "cad5", "cad6", "docl", "doc2", 
"f ileserverl", "atlasl"; 

Each 1- to 63-character client name must match: 

• the client name that is entered in the MS map or the local 
/etc/hosts file 

• the client name that is entered at installation. Make sure to 
use the expanded client name as registered in the NTS map 
(not an alias) 

and 

» the client name that is specified in tlie work-item field 

Repeat this field as many times as you want to add client 
names, or include all the backup clients in a single list. There is 
no default backup list. Unless you specify a client name here, it 
is not backed up. 
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Changes to tliis field take effect immediately. 



Temporarily Disabling to disable backups temporarily for a client without changing its 

Backups for a Client work-group definitionCs), remove the client's name fi'om tliis 

list. (You can .still restore files liacked up from the client.) When 
you put tlie client back in the list, backups resumes normally. 



Authorized Recovery List when you add a Restore User Name to tlie Self Restore Permission in 

the Backup Configuration window, tliat user name is added to 
the authorized recovery list in tlie eb.cfg file. 

You can also add user names manually to the eb.d'g file. Use 
this field to identify' users who can restore files that are backed 
up from their own client system, restoring them on tlieir own 
(that is, the same) client; 

authorized recovery list : "cadi : pat" , "cad2 : ken" , 
"cad3:eric", "cad4 : jane", "cad5:tom", "cad6:bob", 
"docl :mary" , "doc2 : dave" ; 

This ensures that only authorized users can perform a self- 
service restore. Unless you specify this field, no users can 
restore their own files. 

Repeat this field as many times as you want to add user names, 
or include all of the specifications in a single list. Backup 
administrators can always restore their own files, so they should 
not be specified explicitly in this list. 

Identify each item in the list as a clientiuser pair, in this format: 
authorized recovery list : " client : user" , 
..." client: user" ; 

• Specify client as one of the following: 

- the name of the client system 

- an asterisk (*), which indicates any client 
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As an alternative to botli the client and user names, specify 
the name of a netgroup preceded by an @, wliere the 
netgroLip identifies each client:user combination that can 
perform a self-service restore: 

authorized recovery list: "8doc"; 

• Specify user as one of tlie following: 

- the login name of the individual on that client who has 
permission to restore files to that client (illustrated 
below for cadl-cad3): 

authorized recovery list: "cadi:*, "cad2:*", 
"cad3 : eric" ; 

- an asterisk (*), which means that any user who is 
logged into this client can restore the client's files: 

authorized recovery list: "cad6:*"; 

as an equivalent to the asterisk, omit the colon and 
username completely: 

authorized recovery list: "cad6"; 

Changes to tliis field take effect the next time a restore runs. 

You can also disable self-sei'vice restores for all clients by 
leaving the list blank (or by omitting the list): 

authorized recovery list: ; 



Authorized Cross-Recovery use this field to identify' users who can restore files to client 
List systems otlier than those from which the backups originated: 

authorized cross recovery list : " cadi : pa t< cad4 " , 

"cad2 : ken<cad6" ; 

Users who request a cross-restore must either own the files that 
are being restored, or must have read access to tliose files 
under UNIX. Users must also have write and execute permis- 
sions to the destination directory. 
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Repeat this field as many times as you want to add user names, 
or inckide all tlie specifications in a single list. Do not include 
backup administrators in this list. Backup administi'ators can 
always restore from any client system to any other client system, 
regardless of tlie system on wliich they are working. 

Specify the list using the format shown below: 

authorized cross recovery list: " client: user < 
backup_client" ; 

Note: Tlie user requesting a cross-restore becomes the 
owner of the restored files, regardless of the client 
from which they were originally backed up. An 
exception occurs if the user requesting the cross- 
restore is also a restore administrator, in which case 
the original owner is preserv^ed. 

• Specify client as the system to wliich files can be restored 
through a cross-restore. At restore time, this must be the 
client at which the person requests the cross-restore is 
logged in. Specifv?; 

- the name of the client system to which files can be 
restored 

- an asterisk (*), which indicates any backup client 
(illustrated below) where Pat can restore any files to 
(and from) any client system); 

authorized cross recovery list: "*:pat < *"; 

As an alternative to both the client and user names, specify 
the name of a netgroup preceded by an @, where the 
netgroup identifies each tiser that has permission to restore 
files to the clients in die netgroup: 

authorized cross recovery list : "@netgroupa< cad5"; 

• Specifv' user as the name of the user authorized to initiate 
restore on the client identified to the left of the colon. You 
can specify: 
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- the login name of the individual who has permission to 
restore files to that client, as it appears in the autho- 
rized recovery list. Tlie following example gives the 
user Pat permission to restore files that are backed up 
from cad6 to cad 1 : 

authorized cross recovery list: "cadl:pat <cad6"; 

- an asterisk (*), which means that any user who is 
logged into the client can perform tlie cross-restore; 

authorized cross recovery list: "cadl:*< cad6"; 

as an equivalent to the asterisk, omit the colon and 
username completely: 

authorized cross recovery list: "cadi < cad6"; 

• Specify backup_dient as one of the following: 

- tlie name of a client from which files were originally 
backed up (where the files can be restored to the 
indicated client:user) 

- an asterisk (*), w-hich indicates any backup client 

- the name of a netgroup that is preceded by an @, to 
specify the clients in an entire netgroup 

The following example allows any user who is logged in to 
cadi to restore files from any backup client: 

authorized cross recovery list: "cadi < *"; 

Changes to tliis field take effect the next time a restore ams. 



Disabling All Cross-Restores select Restrict cross-Restore to Clients in tlie Client tab in the EDM 

Backup Configuration window to disable all cross-restores, 
except those that the restore administrator list explicitly allows, 
and those tliat the backup administrator performs. 

To do this manually in the eb.cfg file, leave tliis list blank (or 
omit tlie list) to disable all cross-restores: 

authorized cross recovery list: ; 
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Recovery Administrator List use this field to identify users who can restore files other than 

their own to the client from which the files were oiiginally 
backed up: 

The user who requests the restore must be logged in to the 
client from which the files were backed up. 

This feature is designed for use when multiple users share a 
client, to enable a single user on that client to serve as the 
restore administrator for just that client. Repeat tliis field as 
many times as you want to add usernames, or include all the 
specifications in a single list. Backup administrators have all of 
the rights of a restore administrator, so should not be specified 
explicidy in this list. 

Identify each item in the list as a client: user pair, in this format: 

recovery administrator list: " client : user" , 
..." client: user" ; 

Note: The original owner is presented for all files that a 
restore administraloi- restores. 

" Specify client as one of the following: 

- the name of the client. This is the client from which the 
files were backed iip and to which they can be restored 
by the restore administratcsr. 

- an asterisk (*) to indicate any client: 
recovery administrator list: "*:karen"; 

- the name of a netgroup preceded by an @, where the 
netgroup identifies each client in die netgroup. 

" Specify use?- as the name of the restore administrator audio- 
rized to initiate restore on the client(s) indicated. You can 
specify': 

- the login name of tlie user. 

- an asterisk (*) to indicate any user: 

recovery administrator list: "cadi:*"; 
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As an equivalent to the asterisk, omit the colon and 
Lisername completely; 

recovery administrator list: "cadi"; 

Changes to this field take effect the next time a restore luns. 



Disabling Administrator-Level Leave this list blank (or omit the list) to disable all administrator- 
level restore functions except those that tlie authorized cross- 
recovery list explicitly allows, and those that the backup admin- 
istrator perfonns: 

recovery administrator list: ; 



Maximum Simultaneous use this field to specify the global maximum number of work 

Clients items (not clients) the EDM Backup server can back up concur- 

rently, across all trails being written at any one time, lliis field 
controls the total amount of resources the seiver can allocate to 
backup functions, and relates to the sen-ers available 
processing power, memory, and connectivity^ Adjust this field to 
reduce or expand the system resources available for backup 
processing: 

maximum simultaneous clients: 24; 

Specify a value in the range 1-64 (set to 24 at installation). If you 
specify a value that is too small, EDM Backup under-utilizes 
system resources. If you specify a value that is too large, EDM 
Backup saturates the server's virtual memory, which causes 
memory thrashing and reduces performance. 

Changes to this field take effect immediately. 



Use At Most n media-type Your server only has a fixed number of physical drives for 

Trails Concurrently lockup. Besides EDM Backup, other applications on the server 

may need to use these drives, such as the HSM server. 
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Specify one use at most field for each type of backup media, to 
define the maximum number of drives EDM Backup can use for 
each device t>'pe (that is, the maximum number of Q-ails EDM 
Backup can write to that type of media at once), lliis is initially 
set to 4 for each type of device that is available to the sen'er. 

This field has the format: 

use at most n media-type trails concurrently; 
where: 

• « is an integer representing the number of server drives 
EDM Backup can use at any one time. 

• media-type indicates the Vfpe of drive. 

For example, if the EDM Backup server has four tape drives, but 
wants to reserve two drives for non-backup puiposes, you 
specify': 

use at most 2 dlt trails concurrently; 

Changes to tliis field take effect immediately, altliough no 
backups are terminated to comply with the new limits. 



Limit Throughput To: nnn Per use this field to limit the amount of the neuvork bandwidth 
time available to EDM Backup, thereby allowing the network to 

accommodate applications other than EDM Backup. With this 
field specified, EDM Backup monitors its network use. If it 
reaches the specified limit, it does not start another client 
backup until the throughput drops. (However, EDM Backup 
does not stop any backups currently in process if the 
tliroughput exceeds this limit.) Specify no limit if you don't 
want EDM Backup to monitor the network. 

Specify this field in terms of the number of bytes EDM Backup 
can use during a specific time period: 

limit throughput to : bytes per time- units; 
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Wliere: 

• bytes is the number of bytes to which you want to limit the 
throughput, followed by a unit code (set to 6OOKB per 
second at installation). Specify the unit code as follows: 



Unit Code Measure 

k, K, kb, or KB kilobytes 

ni, M, mil, or MB megabytes 

g, G, gb, oj- GB gigabytes 



time-units defines the unit of time during which you want 
to limit tlii-oughput to the number of bytes specified: 



Time Code Limits Throughput Based on the Specified 
Number of Bytes Per: 

secondls) second 

minute(s) minute 

liourCs) hour 



You can combine the time units, as in this example: 

limit throughput to: 15MB per 1 hour 30 
minutes; 

Here are some guidelines: 

- If the seiver is connected to a single Ethernet, set this to 
6 (6()0KB/second). 

- If you have high end clients, two independent FDDI 
rings, 6 CPU SC-1(X)0, and 8 DLT drives, you can set 
this for up to 200 (20MB/second). 

Changes to tliis field take effect immediately. 
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Specifying No Throughput if you want backups to proceed as quickly as possible witli no 

Limit restrictions on throughput, specify no limit (and no other 

options). You may want to do this if you have FDDl or multiple 

Ethernets. 

limit throughput to: no limit; 



Maximum Server backupS.log use this field to specify the maximum size of the backup log file 
File Size {y'usr/epoch/EB/log/backups.log) on the server (generally in the 

range 16KB-256KB). lliis file provides a record of all backup 
activities, limited only according to the size restiiction that is 
specified here. Determining this size is a trade-off between 
using disk space on the server versus keeping the backup 
histoiy for a longer period of time. 

When the file reaches the specified size, EDM Backup locates 
the oldest data in tlie file and expires ten percent of that data to 
free up space for new information. 

The format of this field is: 

maximum server backups.log file size: file-size; 

Where file-size indicates how large tlie file can get before the 
oldest data is expired. Specify tliis field as a number of bytes 
followed by a unit code (set to 256KB at installation). Specify 
the unit code as follows: 



Unit Code 


Measure 


k, K. kb, or KB 


Kilobytes 


m, M, mb, or MB 


Megabytes 


g, G, gb, or GB 


Gigabytes 



If you want to let the file grow until it is as large as the physical 
storage space allows, specify no limit. By not setting a limit on 
the file, it becomes a permanent record of backup operations: 
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maximum server backups. log file size: no limit; 

This example sets die maximum file size for liackups.log to 
2()0KB: 

maximum server backups.log file size: 200KB; 

Note: If you do not limit the file size, it may become too 
large to manage. Also, in HSM systems it is not 
staged . 

Changes to size of the backup log file take effect immediateb 



Maximum Server 
recoveries.log File Size 



Use this field to specify tlie maximum size of the restore log file 
(/'usr,/epoch/EB/log/recoveries.log) on the server (set to 256KB 
at installation). Tliis file provides an audit trail of all restore 
activities, limited only according to the size restriction specified 
here. It can be used to examine exactly what occurred during 
restore processing. Determining this size is a trade-off betW'cen 
using disk space on the server versus keeping audit trails on the 
server for a longer period of time. 



The fo: 



lat of this field is: 



For example: 



.log file 



Specify this field exactly as described for the server's backup log 
file. Willi tlie exception of when changes take effect, these two 
settings are handled exactly the same. 

Changes to die size of the restore log file take effect the next 
time a restore runs. 



Maximum Client backups.log i .se this field to specii\ the maximum size of the backup log file 

File Size ( -ebadmln 'clicnt-ua nie'huckups.log) on each client (set to 

biKB at installation). This file provides a brief record of backup 
acti\'ities for the client. The fcjrmat of this field is as follows: 
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maximum client backups.log file size: file-size; 
For example: 

maximum client backups.log file size: 64KB; 

Specify this field exactly as is described for the sen-'er's backup 
log file. With the exception of the defeult and when changes 
take effect, these two settings are handled exactly the same. 

Changes to this field take effect the next time the corresponding 
client is backed up. 



Maximum Client use this field to specify the maximum size of the restore log file 

reCOVerieS.log File Size (~ebadmin/cfen?-M£/7r;e/recoveries.log) on each client (set to 

64KB at installation), lliis file provides a brief record of restore 
activities for the client, and can be used to locate the more 
comprehensive restore information on tlie sei-ver. 

The format of this field is: 

raaximura client recoireries.log file size: file-size; 
For example: 

maximum client recoveries.log file size: 32KB; 

Specify tliis field exactly as is described for the sei*ver's backup 
log file. With the exception of the default and when changes 
take effect, these tvv'o settings are handled exactly the same. 

Changes to diis field take effect the next time the corresponding 
client is backed up. 



This statement directs catalog processing to schedule a full 
(level 0) backup (instead of an incremental) for any filesystem 
work item when it detects too many files within that work item 
that have never been backed up. (Applies to filesystem backups 
only, as database backups are always full.) 



Catalog Threshold to Force 
Level 0 Backup 
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The concern is for files that do not get backed up during an 
incremental backup because the files were added in a manner 
that preserved the creation and access time of the file prior to 
the last backup of the work item. In this case, you want the next 
backup for that work item to be a level 0. Failure to do this 
causes catalog processing to take a long time and could result in 
a large number of files not being backed up, meaning they 
could not be recovered. 

Also, see "Wlien You Change a Work Item or a Filesystem" on 
page B-35 for times you should force a level 0 backup. 

The format of the field is as follows: 

catalog threshold to force level 0 backup: 
threshold; 

For example: 

catalog threshold to force level 0 backup: 10; 

If ebcatcomp detects more than threshold files that have never 
been backed up for a filesystem work item, it schedules 
(command line scheduling) a level 0 for that work item. If 
threshold is set to zero, the default value, tliis feature is 
disabled. 

Note: 'lliis statement can increase the number of level 0 
backups performed. 

The following alternate wording for this statement is acceptable 
in the server block: 

maximum files not backed up before forcing full 
backup: value; 

This statement can be overridden by a version of this directive 
that can be set within individual filesystem w-ork items. See 
"Maximum Files not Backed Up Before Forcing Full Backup" on 
page B-49. 
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Work Group Fields Work groups define a set of work items of the same t>'pe so that 

a temphite can back them up together (during the same shift 
and using the same trailset) just by referencing their work-group 
name. Specify as many work groups as necessaiy to configure 
your site. If all your clients can be backed up together by using 
a single trailset, specify one work group tliat includes all client 
systems. 

The work-group block looks similar to the following: 

vrork group: "doc" 

{ 

work-item definitions ... 

} 

Note: A work group can Ik- referenced by more than one 
template. Wliile this may result in backing up the 
clients in the work group more oftun than 
necessar\-. it does not cau.se anv conllicis (in media, 
scheduling, etc. ). 

Work items in a work gnjup must hie of the same t\'pe. 1 or 
example, a work group cannot contain file sy.siem work items 
with NetWare work items or diitabase \A'ork items. 

Specify the work-group name as described below, then proceed 
to tlie discussion on coding work items. 



Work Group Name specify the work-group field as any unique 1-63 character name 

used to reference a group of clients, in the following format: 

work group: "work-group name" 

Note: lire work-group name field does not end witli a 
semicolon, but is followed by a brace-delimited 
block that defines its work items. 

Changes to the work-group name take effect the next time 
ebbackup processing runs. 



EDM Software Reference 



B-32 



EDM Backup Configuration File 



Fllesystem Each work group is comprised of one or more work items. A file 

Work Item Fields system work item defines a set of files to be backed up for a 

single client, and infonnation relating to those files (whether to 
back up all the files, resident files only, and so forth). liach 
client requires at least one work item before it can be backed 
up by EDjM Backup. 

The following sample shows a work group. Cllie migration, 
baseline, and completeness fields are used with HSM.) llie local 
work group backs up files on the EDM Backup seiver (named 
adasl), and includes three work items: 
» one work item backs up key database files 
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Work item 

used to back up server 
database files 



• two work items back up die non-database files from each 
of two filesysrems (/' and /home), 
rk group: "local" 

work item: "atlasl : LOCAL_DATABASE" , "atlasl" 
{ 

filespec: LOCAL_DATABASE; 
completeness: DB__COMPLETENESS; 
priority: PRIORITY^SERVERDB; 
level map: LEVEL_MAP_SERVERDB; 



Work item 

used to back up the 

server's root (/) 

filesystem 



atlasl: 



atlasl" 



filespec: "/ -xdev"; 

exclusion tag: " /dev/rsd2C/c0t3d0s4 " ; 
baseline filespec: "/ -xdev -staged"; 
completeness: non-baselined files only; 



Work item 

used to back up the 

server's /home 

filesystem 



work item: "atlasl : /home" , "atlasl" 

{ 

filespec: " /home -xdev" ; 
migration backup tag : "local_home" 
exclusion tag: " /dev/rsd2C/c0t3d0s4 " ; 
baseline filespec: "/home -xdev -staged" ; 
do not load balance; 

completeness : non-baselined files only; 



Some of these options only apply for a particular type of EDM 
Backup client, as detailed in Table B-2. 
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Work Item Options Available by Client Type 



Option 



Applicable if the work item is: 



on a on a 

Migration Non- 
Client Migration 
Client 



Local to the Backup Server 



Level B1 & B2 



work item: 




yes yes 


yes yes 


filespec: 




yes yes 




baseline filespec: 






— yes 


migration backup tag: 






yes' 


exclusion tag: 




yes yes 


yes yes 


piioriiy: 




yes yes 




do not load balance; 




yes yes 




completeness: 








all files 




— ^ yes'' 


yes • — 


resident files only 




yes3 


yes — 


files not backed up in 


migration store 






non-baselined files only 




yes'' — 


level map: 




yes yes 


yes yes 


1. Applies when back 


:ing up staged files 


on an EDM Backup sender that is also an EDM Migration seiver 


2, Only used u'lien y< 


3U reach a project 


milestone or temporarily dcLommissi 


on EDM Backup, to record the 


filesystems exactly 


as ihev stand at that time. 




3. This selling can lea 




unless there's a backup of the client 


store. Specifically, if you don't back up 


a file that's been sta 


iged out, hul you ii 


Dse the file's client store on the serve: 


r tefore the server's files are backed up, 


tlie only way you'll 


be able to restore 


the file is Ixom an old backup. 




4. Default for this die 


ni type. 







Specify each work-item field as described in the following 
discussions. The fields are covered in order as shown in the 
syntax above. Repeat die work-item specifications as many 
times as necessary to configure backups for each client. 
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All changes that are made to the work item take effect the next 
lime ebbackup processing runs. 



When You Change a Work Item when you change a work item's file specification significantly 
or a Filesystem (for example, to add a new filesystem to the backup list), 

always schedule the next backup for that work item as level 0, 
and make sure it is backed up tlie next time EDM Backup runs. 
Failure to do tliis causes catalog processing to take a long time 
and may result in a large number of files not being backed up. 

Other times to force a level 0 ai'e: 

• When a filesystem covered by a work item changes its 
device niunber (such as when reformatted or when moved 
to a new system with the same hostname). 

• When you have added files to a filesystem covered by a 
work item in a manner that preserved the creation and 
access time of tlie file prior to the last backup of die work 
item. See "Catalog Tlireshold to Force Level 0 Backup" on 
page B-29 and "Maximum Files not Backed Lip Before 
Forcing Full Backup" on page B-49. 



When You Stop Using a Work if you stop using a work item — for example, after you create 
Item two work items for a client that previously had one — make 

sure to keep the old work item in the configuration file. If you 
delete tliat older work item, you lose its association with its 
client system, resulting in problems when you run histoiy 
reports. 

To avoid this situation, define one work group that contains 
only obsolete work items, and that is not backed up by any 
template, litis retains the association between each old work 
item and its client, for eaclt work item in the group. 
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Work Item Name specify a 1-63 character name that is unique within the configu- 

ration file. As a conventions, it is good to incorporate the name 
of ilie client when specifying tlie work-item name, as well as 
some indication ol' w'hat files are backed up using the work 
item. EDM Backup generates work-item names that look similar 
to the following when each client is installed (shown for a work 
item that backs up all files on the docl client): 

work item: "docl-all", "docl" 

I Work Item Name 

At a minimum, there is one work item per disk; there can be 
several work items per client. 

Note: In a HSM system, wlien defining k)cal-client work 
items, always specify- one work item lo correspond 
lo each client store that migrated to the senvr. K.se 
that work item to hack up tlie client .store on the 
her\'er. .Vlake sure to include a liackup HS.\I tag in 
the work-item definition, and reference the same lag 
in the corre.spcjnding .store-name definition. 

A work item can hack up an unlimited numlier of files. 
Ilovs'cver. a work item that backs up tnorc than 2S0.()00 files 
will ha\'e siibstiintially slower catalog processing. 

This example shows tlie docl client broken down into three 
work items: 

work item: "dodo/", "docl" 

{ 

filespec: " ... "; 

} 

work item: "doclc/usr", "docl" 

{ 

J p 

work item: "doclo/other" , "docl" 

{ 

filespec: " ... "; 
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Client Name specify the name of the client to which die work item applies, 

as it appears in die audiorized backup list. Always use the 
primary complete name for the client; not an alias. 

work item: "docl-all", "docl" 



FilespeC to Back Up TWs field lists each dil-ectory, filesystem, and/or file that you 

want to back up using the work item. This field has a 4096 
character limit. 

Specify the exact names as they appear in a directory listing by 
using a syntax similar to find. For each directory or filesystem, 
include the name and optional qualifiers. Refei* to Appendix D 
"findxcpio Directives" for more details about the syntax and the 
semantics of specifications diat this field supports. (Also see die 
findxcpio man page.) 



Using the BlCJCk Form of the Syntax The work-item syntax uses a separate statement (not on the 
(Fllespec Statement) same line as die work-item name). 

item: "work-item name", "client name" 

{ 

► filespec: " filespec to back up for level 0-9 backups" ; 

baseline filespec: "filespec to back up when baselining" ; 

migration backup tag: "migration backup template name"; 

exclusion tag: "tag"; 

priority: priority; 

do not load balance; 

completeness : completeness-code; 

level map: "level map"; 
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Backing Up the Local Client it is important that you back up all filesystems that are stored on 

your backup seiver. The server stores die database files for all 
EMC backup and HSM products, as well as the bitfiles (client 
stores) written out by EDM Migration. Also, the product installa- 
tions modify several standard UNIX files, such as /etc/passwd, 
/etc/group, and crontab. 

There is a special ^define matTO for use with the local client, 
which causes it to back up all the servers critical database files: 

filespec: LOCAL__DATABASE; 

The following macro is included in the autoconfigured work 
item for the server's database files (shown below Ibr the atlas] 
sei-ver), and should not be changed: 
work item: "atlasl : LOCAL_DATABASE" , "atlasl" 

{ 

filespec: LOCAL_DATABASE; 
completeness: DB_COMPLETENESS ; 
priority: PRIORITY^SERVERDB; 
level map: LEVEL_MAP_SERVERDB; 

} 



Baseline Filespec The baseline filespec is available if you purchased HSM, and 

applies when you back up the EDM Backup sen-'er's own files 
— generally only the files that are used for stageable 
filesystems. It lists each filesystem for which you want to 
maintain a baseline backup (level Bl, B2. or both), in this 
format: 

baseline filespec: "filespec to back up when baselining" ; 

If you want to maintain a baseline backup for /home, you 
specify: 

baseline filespec: "/home -xdev -staged"; 



Migration Backup Tag include a migration backup tag for use witli level 0-9 backups 

on a local client, when: 
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1. The EDM Backup seiver is also an EDM Migration server 
and 

2. The files that are being l^acked up are the staged (migrated) 
versions of client files 

A migration backup lag is required in tliis case. Specify one 
work itenr for each client store, and include this field: 

migration backup tag: "migration backup template 
name" ; 

Where migration backup template name is a 1-63 character 
identifier. The first 16 characters must be unique across all work 
items that back up the server's own files, and must match 
exactly the migration backup template name that is specified in 
the definition of die migration store used to stage the same files 
from their nelAVork client. 



Figure B-1 



Migration Backup Tag 



Network Client 
Stores 



Client B store-name Definition 
Specifies this Migration Backup 
Tag Name: 




Work Item used to Back Up the 
Client B Store Specifies this Backup Tag: 



The migration backup tag is used to update the backupdates 
database (/'usr/epoch./elc/backupdates), so that a subsequent 
backup of a network client that is migrated to this server can 
determine whether the staged-out client files were already 
backed up on their migration server (tliat is, the server where 
you define tlie work item). 
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Exclusion Tag use this field to identilV any work item that should not be 

backed up concurrently with one or more other woi'k items. For 
each client, specify the same tag value (1-63 characters) for all 
those work items that are mutually exclusive, using this format: 
exclusion tag: "tag"; 

The combination of the exclusion tag and client name forms a 
unique identifier within the configuration file, but you can use 
the same lag value for any number of clients. 

Typically, you use an exclusion tag for work items that back up 
data stored on the same physical disk, to prevent disk thrashing 
during backup processing (shown below for two work items 
that back up files from the rsd2C/c(}t3dOs4 device): 
work item: "atlasl:/", "atlasl", 
{ 

filespec: "/ -xdev" ; 

exclusion tag: " /dev/rsd2C/c0t3d0s4 " ; 

work item: "atlasl : /home" , "atlasl", 

I 

filespec: "/home -xdev"; 

exclusion tag: " /dev/rsd2C/c0t3d0s4 " ; 



If no exclusion tag is included for a work item, ebbackup 
assumes it can process that work item concurrently with any 
otlier work item. 



Connection Via You can install just one copy of the EDM client software on 

UNIX client machines that are equipped with more tlian one 
Ethernet, FDDI, Token-Ring, or ATM port and use it to have 
your backups obtain higher tliroughput rates by taking 
advantage of the multiple network ports. 
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If possible, at least one of the network cards for tlie EDM and 
the clients should be connected to a separate network 
dedicated to backups. This reduces the amount of network 
traffic on the customers' main net\N'ork and reduces the impact 
of backups on tlie users. 

The EDM should be configured on the netwoi-k in a way tliat 
each card uses a single/different client port, lliat is, card "A" on 
the sen'er should talk to "A" on the client and card "B" on the 
server should talk to "B" on the client. Each client port must 
have a distinct clientname. For example: clientname_.A. 



You Gin configure the client's backups to be divided into 
separate backup streams (each defined by a "work item"). You 
can specif}? (in the work item) an alternative port name for one 
or more of the backup streams. 'The clientname is used as the 
name of die default port for backups. (It can match or differ 
from the hostname of the client machine.) 

To set up a fiiesystem work item with an alternate network port, 
add the distinct clientname to the EDM Backup Configuration 
window: select Work Item Options and enter it in the Generic tab. To 
set up online database backups, use the Configure Online Options in 
the Client tab. 

This puts the clientname in a connection via parameter in the 
work item statement in eb.cfg, which specifies it as the alternate 
port name. 



Use this field to assign a priori t\' to the work item, forcing it to 
run either before or after one or more otlier work items. 

When you start a backup, ebbackup searches through its 
schedule for the work items that have tlie highest (that is, 
lowest-numbered) priority. It makes that priority cutrent, and 
processes all work items that have that current priority to 
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completion. Tlien it searches For the next lower priorit)' and 
makes it cun-ent, and so forth, until all work items are 
processed. 

Note: The use of priorities limits the flexibility that is 

available to EDM Backup in choosing what backups 
to run next, and might reduce tlte efficiency with 
which the ser\''er's resources are used. 

If a work item is added to die schedule and has a priority that's 
higher (i.e., numerically lower) than tlie one being processed, 
that work item is started as soon as server resources are 
available, and its priority becomes the current priority. Tliis 
might be the case, for example, if a request is submitted online, 
or cron starts a scheduled backup while another backup is still 
running. 

Use tiTis syntax to specify the priority: 

priority: priority; 

Where priority takes one of two forms: 
» assigned integer in the range -25 to 50, w'here -25 specifies 

the highest priority (mn first) and 50 specifies the lowest 

priority (run last). 
• one of die following ^^define macros: 



Table B-3 






Priority Settings 


Macro 




Equivalent Description 


PIWORI'IT. 


J-IRST 


-25 


Baclojps should run before the general backups. 


PRIORFIY. 


DEI-AULT 


0 


Backups should be considered part of tlie general baclcups (no 
special priority'). Tliis is the initial setting at installation, except for 
the work item used to back up the server's database files. 


PRlORriY. 


.LAST 


25 


Backups should run after the general backups. 


PRIORI'IY. 


_SERVERDB 


50 


Backups should run last. This keyword is reserved for use in backing 
up the seiver's database files (LOCAL_DATABASF,). 
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If die backup server is also an HSM sen-er, EDM Backup 
automatically backs up the stores for each migration client 
before backing up the client files. You do not have to be 
concerned with setting a higher priority lor the local-client work 
items in this case. That way, if tlie level 0-9 backup of a 
networked migration client calls for a backup of a migrated file, 
and the work item specifies a completeness option oi files not 
backed up in migration store, the file do not have to be copied 
back in and backed up again. 

To ensure that tlie migration stores are backed up first for each 
migration client, you must: 

1. Lfse the same priority' for tlie network client and all vi'ork 
items fliat back up tlie client stores on the server (generally 
priority 0, the default). 

2. Set the migration tags correctly for all work items that back 
up the client stores on the server. 

Note: If you purchased HSM (with baselining) and llie 
template specifies do all baseline backups before 
normal backups, the baseline backups always run 
before any level 0-9 backups for that tempkite, 
regardless of tlie priority for any specific work item. 



Load balancing works in conjunction with automatic sched- 
uling, and is the method whereby EDM Backup schedules 
backups as evenly as possible across all clients. By default, EDM 
Backup assumes tliat each work item participates in load 
balancing, which can result in some work items having more 
than one level 0 backup during any given rotation. 

Include the following statement if you do not want the work 
item to participate in load balancing: 

do not load balance; 
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Tliis ensures that the work item does not receive more level 0 
backups during the rotation period than are called for. This 
might be useful, for example, for filesystems that take a long 
time to back up, or for production systems whose resource 
nption is critical. 



I'se this option for files under migration control, to avoid 
performing duplicate backups of the same file data: 

Note: You can u.sc a special ^define completeness macro, 
DIU^O.MPLETENESS. with the local client. This 
macro cc]uales to all files. It is included in the 
auloconfigiired work item for Epoch's dataixisi. files 
and should not be changed. 

I'se this option for files under migration control, to a\oid 
performing unnecessary backup. It limits the files for which the 
data poiiion is written to the backup. (Remember that the 
e.xteiick'd iuodc is included for each file sciinned, regardless of 
whether its data is written out.) 
completeness : completeness-code; 
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Specify the completeness-code as any of the values below. This 
field applies for level 0-9 backups. Hie initial setting varies 
depending on the type of file that is being backed up (as noted 
in Table B-4). Generally it is a good idea to use the defaults. 



Table B-4 


Completeness Settings in HSM Systems 




Code 


Description 


Applicable For 


Default For 


All file.s 


Hack up tile datj portion of all files in the 
fik'spt-c. legardk'.ss ol whcie they're .stored 
and w herher the\ 're haselined. 


All clients (this is the onh 
o]Mi(jn available for backup 
clients that are noi also FDM 
Migiation clients) 


Non-migration 

database files on 
the server 


Residrtit file.s 
only ' 


i^ack up the data portion toi onK those files 
that arc resident (local to) the client; oi, lor 
the .ser\ei. that are stoied on the magnetic 

disk. 


Lev els 0-9 on the backup 
sen'er (i.e.. the local client,!, 
and i:i)M Migration clients 




Mlch not 
backed Lip in 


If a file has been staged, on!) back up the 
data pcjrtion ol the file it its staged \eision 
ha.sn't been iiacked up \et on the HSM servei 


HD.M Migration clients 


L'DM .Migration 
clients 


,\()n-baselined 
files only 


Back up the data portion for onh those files 
that aren't baseline d (lor use after a baseline i,* 
taken). This option is only available il \'ou'\e 
purcha.sed HS.M. 


Local (server) client (but not 
> server's database files) 


local c litnt 
(except sener's 
database files) 



1. It's salcsl II) use ihe nc.\l option (iiles n>n backed up in mioijlion sUjie) with ED.M Mignilion nctvvoik dicnls (and 
non-ba.selined file.'; only loi ihe lotal FDM .Migration client) The re.sicient hies only .setting can leave you vulnerable 
unlcs.s iheK-"s a backup n( the i lieni sioie Specifically, il you don't bai k up a file that's licen .sugcd cnu. bui you 
lose the file's client .sloic on the .seivei Ix-lorc iJie senei's files are bucked up. Uie only vvav you 11 he able to lesloie 
the file is Ironi an old backup. 



LeVSi Map use this option to override the backup level(s) that normally 

occur for tlie work item, based on the template that is used. 
This feature is useful when a few work items need a level of 
backup that is different from most of the work items referenced 
by a template, and saves having to define a separate template 
for tliose work items. 
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The level that a level map specifies completely replaces (in the 
schedule) the level that is otherwise peiformed. EDM Backup 
does not keep a record of the old (replaced) level. 

Note: The level map applies for custom and automatic 

scheduling. Command-line scheduling does not use 
the level map. 

Specif)' the level map by using one of the #define macros that 
are listed in the following table. For example: 
level map: LEVEL__MAP__SKIP_ALL_BUT__LO; 



Table B-5 


Level Map Settings 




Level Map #define Macro 


Equivalent Value 


Description 


LEVEL_AlAP_SK.lP„ALL_BUTJiJ 


"BBOxxxxxxxxx" 


Only run level-0 and baseline backups. Skip all 
other levels. 


li-VliL_MAP_^IWERY1inNG^lS__l.() 


"BBOOOOOOOOOO" 


Run all scheduled baclaips as level-0, regardless 
of the level specified by the template. 


LliVEL_MAP_SKlP_ALL 


" xxxxxxxxxxxx" 


Skip the work item completely. Don't run any 
backups. 


LEVEL_MAP„SERVERDB ' 


"BBOOOOOOOOOO" 


Same as LEVEL„MAP_EVERYTI11NGJS^LD, but 
resen'ed for when backing up the EDM Backup 
sen'er's database files. 



1, The LOCAL-DATABASE work item {for ED.M Backup claKibase files) must alwaws receive a level 0 fiackup. using ihe 
LEVTL_MAP_SERVT.RIDB level map. This simplifies restoring those critical files. 



Alternatively, specif>' any 12-character string you want, where 
each character is indexed to a liaclcup level (BT B2, "Bli" then 
0-9, in that order). Use an x to suppress a level of backup 
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completely. Any other value refers to the level of backup that 
.should occur when the work item is proces.sed at the indexed 



Work item is backed up at level 5. 1 

The foUowing stiing requests that each backup proceed at the 
normally scheduled level, and Indicates that there is only one 
baseline backup: 

level map: "Bx0123456789" ; 

1'hough you cannot remap a baseline backup to a different 
level, you can cause it to be ignored. If the trailset requests a Bl 
backup, for example, you cannot change it from the first id 
(level map; "BxOl...") to file second id (level map: "xBOl..."), but 
you can suppress it entirely: 
level map: "xx0123456789"; 

Here are some examples of level mapping: 

• To cliange level 6-9 backups to a level 5 for the work item: 

level map: "BB0123455555" ; 

• For stable filesystems that seldom change, mn the f3aseline 
and level-0 backups as scheduled, but ignore other levels; 
level map: "BBOxxxxxxxxx" ; 

• For filesystems that change frequently but for which incre- 
mental backups are not used during restore (as for the EDM 
Backup dataliases), am all backups as level 0: 

level map: "BBOOOOOOOOOO" ; 



level. 



Template requests a Level 9 Backup. 

(Level 9 Indexes to the Last Position in the map.) 




level map: "BB0xxxx56785" ; 



EDM Software Reference 



EDM Backup Configuration File 



If yoii are running level 9 backups manually during the day 
(in addition to the automatically scheduled nightly 
backups), you might map the nightly level 9 backups to 
level 5, then specify a separate trail (set of media) for tlie 
levels 5 and 9. The trail that is used to restore files do not 
involve the manually run level 9 incremenlals that are taken 
throughout the day: 
level map: "BB0xxxx5xxx5" ; 

Because the level map is not used when you run command- 
line backups, the level 9 incrementals that are run from the 
command line actually perform level 9 backups. 

If you want to suppress all backups: 
level map: "xxxxxxxxxxxx" ; 



Access Time Preservation Two alternative statements are available for clients tliat do not 

allow imnsible file access. 

(With invisible file access; neither atime nor ctime is updated 
when files are backed up. Clients that support invisible file 
access: Solaris 2.1 or higher for SPARC, SunOS 4.T3 for SPARC. 
I'his setting does not apply to tliese clients.) 

For all other clients, you can decide whether each night's 
backup process itself either: 

• preserves the original change time (ctrme), but updates 
each file's access time (atime) to the time of die backup, or 

• presei-ves the original access time (atime), but updates each 
file's change time (clime) to the time of the backup 

To preserve the original ctime, use 

preserve file change time during backup; 

To preserve tlie original atime, use 

reset file access time after reading file; 
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Note: With "reset file access time after 

reading file;" incremental backups do not 
check the ctime For changes as drey do with 
"preserve file change times during 
backup;". The result: for applicable platforms, if 
you perform functions that change the inode, such 
as chmod, these changes are not recorded during 
incremental backups. 

These two options are mutually exclusive. (If botli are applied, 
a semantic warning is issued during backup processing and 
then the system's default operation — preserving ctime but 
updating atime — - is performed.) 



Maximum Files not Backed Up 
Before Forcing Full Backup 



The concern is for files that do not get backed up during an 
incremental backup because the files were added in a manner 
that preserved the creation and access time of the file prior to 
die last l:)ackup of the work item. In this case, you want the next 
backup for that work item to be a level 0. Failure to do this 
causes catalog processing to take a long time and could result in 
a large number of files not being backed up, meaning they 
could not be recovered. 

Also, see "'^■lien You Change a Work Item or a Filesystem" on 
page B-35 for times you should force a level 0 backup. 

The format of the field is as follows: 

maximuiTi files not backed up before forcing full 
backup: value; 

For example; 

maximum files not backed up before forcing full 
backup: 10; 



This .statement directs catalog processing to schedule a full 
(level 0) backup (instead of an incremental) for this filesystem 
work item when it detects too many files within this work itetn 
that have never been backed up. (Applies to filesystem backups 
only, as database backups are always full.) 
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If ebcatcomp detects more than value files tliat have never 
been backed up for this fiJesystem work item, it scliedules 
(command line scheduling) a level 0 for this work item. If value 
is set to zero, tlie default value, this feature is disabled. 

Note: lliis statement can increase the number of level 0 
backups perfomied. 

This statement overrides a version of tliis directive tliat can be 
set in the server block, which applies to any filesystem work 
item. See "Catalog Threshold to Force Level 0 Backup"' on page 
B-29. 



Database Note: 'Ilrese "Database Work Items" pertain to the so- 

Work ItSin FiBldS called "offline database backup" functionality 

supported prior to EDM 4.4.0 and are included here 
to support restores only. These work item specifica- 
tions do not apply to tlie various database backup 
clients that are currently supported for backup. 

Support for new backups using the "offline database backup" 
functionality are not supported as of EDM 4.4.0. Nor does EDM 
4.4.0 support any reconfiguration of these database work items 
or configuration of new ones. 

However, support for restore of backups taken using the 
"offline database backup" functionality continues in EDM 4.4.0, 
and to be aide to restore such a liackup depends on the 
continued presence of its particular database work item in your 
eb.cfg. Hence this section continues to be included in this 
revision of the EDM Software Reference manual. 

Note: The w'ork items that pertain to the various database 
clients are documented in the individual database 
client guides as appropriate; they are not included 
in this appendix. 
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A database work item defines a set of databases to be backed 
up. The following is an example. 

work item: "chipmunk :inaster+ : Sybase" , "chipmunk" 

{ 

filespec: "DO_FILE_LIST /ext_ibm/sybase/master. dat" ; 

database type: "sybase"; 

database server: "SYBCHIP"; 

database name: "master model tempdb"; 

inclusion tag: "chipmunk : SYBCHIP" ; 

type: coordinated; 

backup client initialization command: "-exec_as 
'Sybase' -DBServer 'SYBCHIP' ebcv_shutdown 
Sybase" ; 

backup client cleanup command: "-exec_as 'sybase' 

DBServer 'SYBCHIP' ebcv_startup sybase"; 
use connection method: netware@514; 

} 

In the discussions that follow, the fields are covered in order as 
shown in the example above. The ivork Hem specifications are 
repeated as many times as necessary to configure backups for 
each client. 

CAUTION: These database work items must remain as 
they are for restores of their corresponding 
backups to work. 



Database Work Item Name The database work item name that is generated during auto- 

discovery is of tlie format database_natne\+hdatabase_type\:n]. 
If multiple databases were backed up in a work item, then 
database_name represents one of the database names (chosen 
arbitrarily), and a plus sign (+) is appended to the name. 
database_t}pe is one of oracle, informix, or sybase. 

Because a database work item name must be unicjue, an integer 
was appended if necessary to make it unicjue. 
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Client Name 



Tliis is name of the client to whicli the work item applies, as it 
appears in the authorized backup list, Always use the primaiy 
complete name for the client; not an alias. 

work item: "docl-all", "docl" 



Filespec 



I'he DO_FlLE_lJST in this field specifies a file on the client that 
lists each file associated with the database that was found 
during database auto-discovery. This field has no character 
limit. 

filespec;"DO_FlLEJJST /extjbm/sybase/'master.dat" 



Partition Spec 



The D(3_PART_LIST specifies a file on the client that lists each 
raw partition associated with the database that was found 
during database auto-discoveiy. 



Database Type 



This syntax specifies die database type: 
database type: " database jype" ; 

Database type is one of: Informix, oracle, sybase, or none. 



Database Server 



This field sets the name of the database server for the work 
item. The syntax is: 

database server: " data base_seruer_n am e' ; 



Database Name 



This field contains one or r 
spaces. 



re database names, separated by 
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Type For a database work item, this field must be as follows; 

type: coordinated; 



Exclusion Tag Tlils field identifies any work item that should not be backed up 

concurrently with one or more other work items. For each 
client, the same tag value (1-63 characters) is specified for all 
those work items that are mutually exclusive, using this format; 
exclusion tag: "tag"; 

For more information, see "Exclusion Tag" on page B-40. 



inciusion Tag a single database might he backed up by tw'o work items: one 

for the raw partition, and another for the files. The inclusion tag 
is used to coordinate back up of work items tliat refer to the 
same database. By defatilt the inclusion tag value is the work 
item name. The syntax is; 

inclusion tag; "inchision_tag''\ 



ACCGSS "nme Preservation Two alternative statements are available for clienLs that do not 

allow invisible file access. 

(With invisible file access; neither atime nor ctime is updated 
when files are backed up. Clients that support invisible file 
access: Solaris 2,1 or higher for SPARC, SunOS 4.1,3 for SPARC, 
This setting does not apply to tliese clients.) 

For all other clients, you can decide whether each night's 
backup process itself either: 

• presei-ves the original change time (ctime), but updates 
each file's access time (atime) to the time of the backup, or 

• preserves the original access time (atime), but updates each 
file's change time (ctime) to the lime of tlie backup 
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To preserve tlie original ctime, use: 

preserve file change times during backup; 

To presei-ve tlie original atinie, use: 

reset file access time after reading file; 

These two options are mutually exclusive. (If botli are applied, 
a semantic warning is issued during backup processing and 
then the system's default operation — preserving ctime but 
updating atime — is performed. 



Priority This field assigns a priorit>' to the woi'k item, forcing it to run 

either before or after one or more other work items. See 
"Prioritv?" on page B-41 for more information. 



Do Not Load Balance Load balancing schedules backups as evenly as possible across 

all clients. Tlie following statement excludes the work item from 
load balancing: 

do not load balance; 

Foi- more information, see the discussion under File System 
Work Item Fields, "Do Not Load Balance" on page B-43. 



Backup Client Initialization This is the ebcv_shutdown command that is run on the 

Command database client before shutdown. 

The command parameters are 

-exec^as username \ 

-DBServer servername \ 

-DBA database_administrator_name \ 

-DBAIdent encrypted_dba__password \ 

da tabase_type 

Do not attempt to edit the encrypted password. 
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Initialization Timeout riiis field specifies the amount of time to wait before the 

shutdown and backup are considered to have failed and the 
attempt is terminated. The syntax is: 

backup client initialization timeout: n day n hour n minute n second; 



Backup Client Cleanup This is tlie ebcv_startup command that is run on the datai^ase 

Command ci ient before restarting the database. 

The command parameters are: 

-exec_as username \ 

-DBServer sewername \ 

-DBA database_admmistmtor_name \ 

-DBAldent enoypted_dba password \ 

databasejype 

Do not attempt to edit the encrypted password. 



Cleanup Timeout Amount of time to wait before the restart is considered to have 

failed and is terminated. Note that this has no effect on the 
actual backup. The syntax is: 

backup client cleanup timeout: n day n hour n minute n 
second; 



Buffer Sizes The buffer sizes for the server and clients can be tuned for 

better backup and restore performance, lite buffer sizes you 
choose depend on your site's configuration, factors that 
influence the optimum buffer size settings are: the numt)er and 
type of libraiy units and RAM in the backup server. 

The syntax of the buffer size fields is: 
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backup client data buffer size; n MB; 
backup seiver data buffer size: 11 MB; 
recoveiy client data buffer size: n MB; 
recover)' server data buffer size: 11 MB; 



Backup Start Hme This field specifies an additional qualification to the start time 

for nightly processing, which is specified in a crontab entry. The 
default crontab start of nightly processing is 11:00 p.m. 



Level Map This option overrides the backup leveKs) that would normally 

occur for die work item, based on the template used. 

Foi- more information, see "Specify the completeness-code as 
any of the values telow. This field applies for level 0-9 
backups. The initial setting varies depending on the t>'pe of file 
that is bieing backed up (as noted in Table B-4). Generally it is a 
good idea to use the defaults." on page B-45. 



PC Work Item Fields These fields are used for all PC clients: NetWare, OS2, and 

Windows NT Backup Clients and for OpenVMS Backup Clients. 
In several cases the word netware is embedded in the code, but 
the field is used for all l^C clients. 

Note: For details, see the appropriate client manual. 
The following is a sample Windows NT work item. 

work item: "prince : /C/" , "prince" 
{ 

filespec: "CO^FS /C/"; 
exclusion tag: "PRINCE__HarddiskO" ; 
use connection method: netware@3895; 
netware username: "supervisor"; 
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Note: The "DO^FS" directive is not valid for NetWare and 

OS/2, 



Work Item Name This field defines the files to be backed up from a single client's 

resource. For example, the default syntax for Windows NT is: 

woMtem-''sewername:resou7xe'\''sewername'' 

sewername is the name of the PC server, resource is the PC file, 
directoiy, or volume to be backed up. 



Connection Method The connection metliod defines the TCP/IP port on which the 

client is listening for a command from the backup seiver. The 
syntax is: 

use connection metliod; netware@«n?»Z; 



where ininn is the port ni 


amber. 


NetWare default 


nenvare@1776 


OS- 2 default 


net\vare@1492 


VX'indowN NT default 


nerware©3895 


()pen\MS delault 


netware©3896 


NT sgi. .Ser\er 


netware® 5600 



It must be the same as the port number that is set on the 

PC server. If you change one, you must change diem botli and 

rerun the configuration on the PC server. 



FilespeC Inle specification describes the files to be backed up on the 

client. 
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Netware Username 



The netware username entry determines what PC user privilege 
can execute backups and restores. For detailed information on 
how this works for individual clients, see the appropriate client 
manual. 



Netware Encrypted Password 



The netW'are enciypled password entry provides the required 
password to the user who can execute backups and restores. 
Do not attempt to edit it directly. Make any changes tlirough the 
EDM Backup Configuration window. 



Netware Client TSA 



The netware client TSA entry assigns a target s 
the PC server. 



In NetWare, OS/2, and Windows NT tlie fomiat i, 
servername . filesystem 



Netware Client Target 



The netware client target defines a PC client as a target in need 
of sei-vice. 



Exclusion Tag 



The exclusion tag ensures single-threaded processing for the 
client. All work items with the same exclusion tag execute 
sequentially. Backup processes proceed one at a time. 



Backup Trailsets 



A backup media set (trail set) defines all of the trails that are 
used for one or more work groups, (including the type of media 
to which the backups should be written for each level). It 
defines the retention peiiod for the backed up data and related 
catalogs and saveset records. It also defines the level at which 
you want to compress the catalogs (to save disk space). 



EDM Software Reference 



B-59 



Backup Trailsets 



When running ebbackup, you identify the schedule template to 
use. Tliat template references to other types of configuration 
constructs; 

• one or more work groups 

• the IrailsetCs) that you want to use to back up those work 
groups 

Each template requires one trailset (called the primaiy trailsetX 
and can include a second {alternate) trailset. Generally the 
alternate trailset is used for off-site storage. 

The backup trailset is similar to the following (for simplicity, 
only information for levels 0 and 9 are used): 

backup trailset: "on site 1" 
{ 

use trail: "fulls-tape" , dlt for level 0, 
using at most 8 clients concurrently; 

duplicate media after backup on 1 copy, 

appending to current media copy; 
use trail: "incr-dlt", dlt for level 1-9, 
using at most 8 clients concurrently; 
use trail: "baselines", EO for level Bl, 
using at most 8 clients concurrently; 
use level Bl for baseline backups; 
keep backups of level 0 for: 1 year; 
keep backups of level 9 for: 3 months; 

keep duplicates of level 0 for: 1 year; 

keep duplicates of level 9 for: 3 months; 
keep backup catalogs of level 0 for: 1 year; 
keep backup catalogs of level 9 for: 3 months; 
keep saveset records of level 0 for: 1 year; 

Note: Duplicate media information (as shown in lines 5, 6, 
14, and 15 of tlie above example) appears only if 
media duplication is configured. If new media is 
requested for duplication, the line "using new media 
at each duplication" appears in place of line 6. If 
manual duplication is enabled, the line "manual 
activation of media duplication" appears after line 6. 
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Specify as many media sets (trailsets) as necessary to configure 
your site: one for each unique combination of backup levels, 
media, and length of time to keep the backup dat;i, catalogs, 
and saveset records. 

Note: The fewer backup schedule templates, trailsets, and 
trails you use to configure your site, the fewer 
backup volumes EDM Backup needs to access 
during processing. 

Define each field as described in the sections that follow. 



Backup Trailset Name use tlils field to specify a 1-63 characta- name for the trailset 

(defaults to priniar)> at installation). This name must be unique 
within the configuration file: 

Note: Tlie trailset name field does not end with a 

semicolon, but instead is followed by a brace- 
delimited block tliat defines its trails. 

Changes to the trailset name take effect the next time 
cbbackup processing runs. 



Use Trail use this field to specifv' the trail, including the name for the 

collection of media designated by the trail, the type of media 
that is used, the level of backups written to the trail, and the 
maximum number of clients that can be backed up concurrently 
to tliis trail (vs. the maximum number of clients that can be 
backed up concurrently for the entire server, and specified by 
using the global maximum simultaneous clients field in the 
server block). 

You can have up to 12 trails per trailset — one for each backup 
level (0-9, Bl, and B2). Each baseline level requires its own 
trail. Levels 0-9 can share trails. You generally want one or two 
trails for levels 0-9, plus the baseline trail(s). 
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This field can take two forms, and includes four fields: the trail 
name, media t>'pe, backup level, and number of concurrent 
clients. Each field is described following the syntax below: 
use trail: " trailname" , media-type for level n, 
using any number of clients concurrently; 

or 

use trail: "trail name", media-type for level n, 
using at most n clients concurrently; 

Changes to the use trail portion of the field take effect the next 
time ebbackup processing runs. Changes to the using . . . clients 
concurrently portion take effect immediately. 

Specify the trail name as 1-11 characters. Trail names are used 
in volume management as part of the volume label name. For 
levels 0-9, the trailname and the media type are combined to 
form the label name. For baselines, the trail name is die entire 
label name. 

Note: Tire more trails you use for each set of work groups 
that are backed up together, the more overliead 
you'll incur in terms of media management and 
tracking. 

Specify the type of media to which the trail is written. 

Specify the level(s) of backup you want to write to tliis trail, 
using one of three formats: 

• A single level (0 through 9, Bl, or B2): 

use trail: "trail_l", dlt for level 9, ... 

• A range of levels: 

use trail: "trail_l", dlt for levels 0-9 ... 

• A compound (AND) statement that includes two levels, or 
ranges of levels: 
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use trail: "trail^l", dlt for levels 5 and 
levels 8-9 ... 

Only use level Bl or B2 if you purchased HSM, to indicate 
whetlier you want to maintain a level B] or B2 backup. If you 
want to maintain uvo baseline levels, specify one trail as Bl and 
the other as B2. 

Note: Never write level Bl and B2 backups to the same 
trail. 

If you identify more tlian one trail for a particular level, the last 

specification overrides the others, hi the following example, 

EDM Backup uses the incr-dlt lmi\ for level 9 and mid-dlt for 

level 5, even tliough levels 9 and 5 were included in tlie range 

of levels specified for the (first) fulls-tape trail: 

use trail: "fulls-tape", dlt for levels 0-9, 

using at most 8 clients concurrently; 

use trail: "incr-dlt", dlt for level 9, 

using at most 8 clients concurrently; 

use trail: "inid-dlt", dlt for level 5, 

using any number of clients concurrently; 

Make sure to include every level of backup you want to run in 
at least one trail. For example, if you want to perform level-5 
backups from the command line, you must define level 5 
somewhere in the trailset. It is best always to include a i*ange of 
levels (for example, 0 through 9) for each t]-ail, even though 
some levels may never be used. (Automatically scheduled 
backups only use levels 0 and 9, for example.) 



Maximum Number of Concurrent Specif>' the maximum number of work items (not clients) that 
Clients can be backed up at the same time to tliis trail, in the range 1-24 

(defaults to 8 at installation): 

using at most n clients concurrently; 

Alternatively, specify as many work items as possible (up to the 
number indicated by the seiver block's maximum simultaneous 
clients field): 

using any number of clients concurrently; 
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The recommended setting is from 2 to 8; 

• Use a lower number (for example, 2-3) if the trail is used 
mostly for full backups, or for incrementals that include a 
lot of file data (vs. extended inodes only) 

• Use a higher number (up to 8) if the trail is used mostly for 
sparse incremental backups 

• Choose a value in between if the ti-ail is used for some 
combination of full backups and sparse incremental 
backups 

This setting is used in conjunction with the system-wide (server 
block) maximum simultaneous clients field, to control the use 
of system resources. Regardless of the trail-level setting, there 
will never be more work items processed concurrently than are 
specified by the system-wide value. 

For example, if you are using two trails that each specify four 
work items but your system-wide work-item limit is six, there 
can never be more than six work items writing to the two trails 
combined, at any one time, hi this situation, EDM Backup: 

• Starts backups on four work items using the first trail. 

• Starts backups on two more work items using the second 
trail, bringing tlie total number of work items processed by 
the server to the limit. 

• Starts a new work item each time an active work items 
finishes, keeping the total number of work items to six. In 
juggling the work items, EDM Backup does its best to allot 
equal resources to all scheduled work items. 

1'his example is illustrated in Figure B-2 (where, for simplicity, 
assume one work item per client). 
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<-2 Backup Processing 

EDM Backup starts six work- When a work item finlslies {1), As eacfi work Item finishes (3), 
items — 4 use the 1 st trail, 2 EDM Backup starts a new work EDM Backup starts a new one (4). 
use the 2nd. item (2). 



i_ 1 — n 


Backup Completes " } \ 


n « o 




n-« 

' ^ 0 Backup Completes ' ' 








(2) Start a New Work item' ,^3""^ 


1st Trail ' 




2nd Trail jp^;^ 






Jl || Active Backups 


0 Start a New Work Item 



[I Completed Backups 



Use Level B1 1 B2 ¥or Baseline If you are using automatic scheduling, the scheduler writes a 

Backups baseline backup to a Bl level trail. If an alternate trailset is 

configured witli a B2 level ti'ail, tlie autoscheduler writes an 
alternate night baseline backup to a B2 level trail. 

Note: The entr>' "use level Bl for baseline 
backups; " in tlie eb.cfg file is ignored by the 
backup scheduler. The B2 level is always used for 
baselines on alternate night as long as the alternate 
trailset is configured with a B2 baseline trail. 
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Specify at most one baseline level per trailset. if you include this 
field, make sure to specify a use trail statement for the baseline 
backup. 

Omit this field if you are not writing baseline backups to tlie 
trailset, or if you plan to request all baseline backups via custom 
or command-line scheduling. This field is ignored with custom 
and command-line scheduling. 

Changes to tliis field take effect the next time EDM Backup 
schedules work items. 



Use this field to indicate how long to retain the backup data 
before reusing the backup media. Specify tliis field by using the 
following format, repeating it as many times as necessaiy to 
configure expirations for your site: 

Note: If you identify more than one trail for a particular 
level, the last specification overrides the others, 
keep backups of level n for: time-period; 

where: 

• n specifies tlie backup level (s) to which tlte setting applies 
(0-9), by using one of three formats as described for the use 
trail statement (a single level, range of levels, or compound 
statement that combines levels). 

Generally you define the same levels (or set of levels) here 
as are specified via use trail statements for the same u-ailset. 

Note: This specification does noi apply for baseline 
backups. 
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• time-period defines the amount of time to retain the 

backups for this level, specified as an integer followed by 
an appropriate units value. 

Units 

second(s) 

dayts) 

week(s) 

month(s) 

year(s) 

forever ido not include an integer) 

You can expire backups immediately: 

keep backups of level 2 for: 1 second; 

O]- keep them indefinitely: 

keep backups of level 0 for: forever; 

You can combine the time units, as in the following example: 

keep backups of level 9 for: 1 year; 6 months; 

Always expire backup data before (or at the same time as) the 
con-esponding saveset records, but after (or at the same time as) 
the coiTesponding aitalogs. An exception occurs if you specify 
keep backups forever, in which case you can expire tlie saveset 
record without expiring the media. Make sure to cover every 
backup level tliai is used. 

The recommended setting (and the initial value at installation) is 
1 year for level-0 backups, and 3 months foi" levels 1-9; 

keep backups of levels 0-9 for: 3 months; 
keep backups of level 0 for: 1 year; 

Note: If you identif)? more tlian one expiration for a 

particular level, the last specification overrides the 
others. 
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If you omit tills field, it defaults to forever. 

Changes to diis field take effect immediately, but do not affect 
any curi-ently running work items. 



Use this field to indicate how long to retain a duplicate of 
backup data before reusing the duplicate's media. Specif^' this 
field by using the following format, repeating it as many times 
as necessary to configure expirations for your site: 

Note: If you identify more than one trail for a particular 
level, the last specification overrides the others. 

keep duplicates of level n for: time-period; 

where: 

• « specifies the backup level(s) of the duplicate, to wliich 
the setting applies (0-9). 

• time-period defines the amount of time to retain the dupli- 
cates for this level, specified as an integer followed by an 
appropriate units value. 

Note: Refer lo"Keep Backups" on page B-65 for more 
information about tiiese fields. 

You can expire duplicates iimnediately: 

keep duplicates of level 2 for: 1 second; 

Or keep them indefinitely: 

keep duplicates of level 0 for: forever; 

You can combine the time units, as in the following example; 

keep duplicates of level 9 for: 1 year 6 months; 

Note: You must expire duplicate data before (or at the 

same time as) the corresponding backup data. Refer 
to "Rejecting a Mount Request" on page 9-29 for 
more information. 
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Keep Backup Catalogs use Ms field to indicate how long to keep the backup catalogs 

created for each level 0-9 backup. Always expire the catalogs 
before, or at the same time as, the media (above). 

The format of this field is: 

keep backup catalogs of level n for: time-period; 

Where n and time-period are specified as descjibed above for 
the keep backups setting. Make sure to cover every backup 
level used. 

The recommended setting (and the initial value at installation) is 
1 year for level-0 backups, and 3 months for levels 1-9: 

keep backup catalogs of levels 0-9 for: 3 months; 
keep backup catalogs of level 0 for: 1 year; 

Note: If you identify more tJian one expiration for a 

particular level, the last specification ovenides the 
others. 

You should expii-e the catalogs for incretnental backups aggres- 
sively to free up disk space, because: 

1. You rarely restore files from older incremental backups and 

2. You can reconstruct the catalogs from the backups, if 
necessary 

If you omit diis field, it defaults to forever. 

Note: See Chapter 10 "Magnetic Disk Concepts". 

Changes to tliis field take effect immediately, but don't affect 
any currently amning work items. 



Keep Saveset Records use this field to indicate how long to keep the saveset records 

created for work items written to this trailset. Saveset records 
are necessaiy during a restore, to locate backup data and 
catalogs. Because of this, you can't generally expire saveset 
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records before either the backup data or the catalogs. An 
exception occurs if you specify keep backups forever, in wliich 
case you can expire the saveset record. 

The format of this field is: 

keep saveset records of level n for: time-period; 

Where n and time-period are specified as described above for 
the keep backups setting, except that you can specify Bl and 
B2 as well as levels 0-9. Make sure to cover every backup level 
used. 

The recommended setting (and the initial value at installation) is 
1 year for level-0 and baseline backups, and 3 months for levels 
1-9: 

keep saveset records of levels 0-9 for: 3 months; 
keep saveset records of level 0 for: 1 year; 
keep saveset records of level Bl for: 1 year; 

Note: If you identify' more than one expiration for a 

particular level, the last specification overrides tlie 
others. 

If you omit tliis field, it defaults to forever. 

Changes to lliis field take effect immediately, but don't affect 
any currently running work items. 



Backup Catalog Delta Level use this field to specify the backup level at which you want 
EDM Backup to consolidate catalogs (1-9). 'llie recommended 
setting (and the initial value at installation) is 9: 

backup catalog delta level: 9 

If you omit this statement, the backup catalogs are consolidated 
at level 1. 

When EDM Backup consolidates the catalogs, it turns all the 
catalogs for the level specified — as well as any numerically 
higher levels — into deltas, which only contain information that 
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differs from tlie more recent catalogs. If you specify a delta level 
of 5, EDM Backup compresses the catalogs for level 5-9 
backups. 

EDM Backup recreates the full catalog from a delta as necessary 
during a restore, by adding back the information that was origi- 
nally compressed out. It uses as input all subsequent catalogs 
for tlie work item, up to (and including) the most recent 
catalog. 

The latest catalog for any particular work item is always uncom- 
pressed, to provide fast access during restore processing. For 
the same reason, level-O catalogs are always uncompressed. 

Changes to this field take effect immediately, and could affect 
work items currendy being backed up, but not any whose 
catalog is currently being processed. Since this field is used by 
catalog processing after backup processing, it should take effect 
on the next catalog to start being processed by ebcatalogd and 
ebcatd. iTiis could be the currently running work items, since 
their catalogs have not been processed yet. 



BSCkUP T6rnpl3t6 Fields a backup schedule template describes how to back up a group 
of clients, grouping together work groupCs) and trailsets. You 
can have as many backup schedule templates as you want, but 
you must have at least one. The template specifies- 

• The list of work groupCs) to back up. 

• T'he rotation period to use and date to start the first rotation. 

• The trailset(s) on which to store the backup data for clients 
in the work group(s). Each backup template has a primaiy 
trailset, and may have an optional alternate trailset. 
Generally the alternate trailset is used for off-site storage. 

• Whether to force all baseline backups to finish before any 
level 0-9 backups can start (available only if you've 
purchased HSM). 
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• Whether to recreate tlie baseline backup if necessar}' 
(available only if you've purchased HSM). 

• Information about the log files and completion reports. 

• Scheduling specifications. 

Specify the template fields as described in the sections that 
follow. 



Specify this field as the 1-63 character name for the template: 

backup template: "template name" 

Note: The template name field does not end with a 
semicolon, but is followed by a lirace-delimiled 
block that defines its specifications. 

The template name must be unique within the configuration 
file. You'll reference the template name when you invoke 
ebbackiip to start a backup. 
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backup template: "sales-all" 

{ 

work group list: "sales", "local"; 

begin trailset rotations on: Dec 13, 1993; 
rotation period: 7 days; 

primary trailset: "on site 1", use new volume 
each rotation; 

alternate trailset: "off site 2", use new volun 
each rotation; 
logging level: stats; 

server logfile: "sales-all__template.log", 256 
backup completion script: "mailok"; 
backup failure script: "mailerr"; 

do all baseline backups before normal backups 
recreate baseline if needed; 
schedule : 
{ 

/* standard rotations; */ 
/* full during weekends rotations; */ 
weekday backup shift is 8 hours; 
weekend backup shift is 24 hours; 
level 9 on Monday, Tuesday, Wednesday, Thursc 
Friday; 

for "sales", level 0 on Saturday; 
for "local", level 0 on Sunday; 



Note: If you remove a template from the configuration 
file, it remains in the schedule, as do any work 
items scheduled for that template. To remove a 
template completely, first remove it from the config- 
uration file, tlten use ebbackup with the -retire 
option to delete it froin the schedule. 

Changes to the; template name take effect the next time 
ebbackup processing runs. 
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Work Group list use the workgroup list to specify the work groups that are 

backed up togetlier using this template. This is a shorthand 
method of identifying each work item individually. See "Work 
Group Fields" on page B-31 for information about defining 
work groups. 

The format of this field is: 

vjork group list: "work group", "work group", 
..." work group" ; 

Changes to tills field take effect the next time ebbackup 
processing ams. 



Begin Trailset Rotations This field specifies when EDM Backup should begin using the 

template (for a new template, it defaults to the date the template 
is added). It applies for all work items in the template, and for 
botli automatic and custom scheduling (but not for command- 
line scheduling). 

If you want to create a new template, but do not want to start 
using it yet, use this field with the data when the template is to 
be used, llie format of this field is: 

begin trailset rotations on: date; 

Where date takes one of three formats: 



Format 


Example 


dd-mmm-\'y 


13-dec-99 


mm/dd/y)f 


12/13/99 


mmm dd, yy 


Dec 13, 99 


mmm dd, yyyy 


Dec 13, 1999 



Leading zeros are not required. EDM Backup interprets the 
centuiy using standard UNIX conventions: 
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• Years in the range 7()-99 are in the 20th century (i.e., 19)3') 

• Years in the range 0-37 are in the 21st centuiy (i.e., 20);)') 

• Years in tlie range 38-69 arc illegal — EDM Backup can't 
create timestamps for these years because of a UNIX 
restriction 

Changes to this field take effect the next time EDM Backup 
schedules work items. 



Rotation Period Iliis field indicates how often each client should receive a level 

0 backup (autocoiifigured to every 14 days). For automatic 
scheduling, it's used by EDM Backup to compute the schedule 
of level 0 and level 9 backups, ensuring at leiist one level 0 
backup during each rotation. I'or custom scheduling, it serves as 
the point of reference when defining tlie backup schedule (for 
example, run level 0 backups on the 1st day of each rotation, 
and run level 9 backups on days 4, 8, and 12). 

The rotation period also indicates when EDM Backup should 
start a new media rotation for the template. By default, EDM 
Backup starts writing to a new set of media on day 1 of each 
new rotation. You can oveiride this either in the statement that 
defines what trailsets to use (described under "Primary and 
Alternate Trailsets" on page B-75), or on the command line, 
when you run ebbackup. 

The format of this field is shown below; 

rotation period: n time-units; 

Where: 

• 71 is any integer greater tlian 1. The most common rotation 
periods are 7 days, 14 days, or 28 days. For automatic 
scheduling: 

- Use a 7-day rotation if restore time is important and you 
can afford the resources necessaiy to maintain a full 
backup every seven days. 
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- Use a 14-day rotation (the installation default) unless 
you have a good reason to use a different setting. The 
] 4-day rotation consen'es media and generally offers a 
good restore rate. 

- Use a 28-day rotation to minimize the use of backup 
media, or for filesystems tliat change little over time 
(such as / and /usr). Restoring files will be slowest with 
this schedule, because there may be more incremental 
backups to read; however, the effect should t>e minimal 
if your data changes Htde over time. 

• time-units defines tlie unit of time in which the rotation 
period is specified: 

Units 

day(s) 
week(s) 
month(s) 
year(s) 

For example, to automatically perform a full backup eveiy 7 
days on the clients named by the work group, enter: 

rotation period: 7 days; 

Changes to tliis field take effect the next time ED.M Backup 
schedules Vk'ork items. 



A template must specify one trailset, and can specif^' two, 
known respectively as the primaiy and alternate trailsets. 

Specify the trailset(s) using this format: 

primary trailset: " tzailset name", 
use new volume on each rotation; 
alternate trailset: "trailset name", 
use new x'-olume on each rotation; 
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Where: 

» The trailset name identifies the trailset to wliicli backups 
are written, and must specify a name that's defined already 
in the configuration file (set to "primary" at installation). 

» The clause use new volume on each rotation directs EDM 
Backup to start a new volume(s) at tlie beginning of each 
rotation period. This separates backups from different 
rotation periods into distinct volume sets. 

If you specify an alternate trailset, EDM Backup switches 
ber^'een die two trailsets each day, scheduling the primary 
trailset on odd-numbered days with respect to the template's 
rotation period, and the alternate trailset on even-numbered 
days. With automatic scheduling, this provides a second 
separate set of backups on alternating nights. If the rotation 
period specifies an even number of days, the uvo sets of 
liackups are nearly the same, differing only by one day's worth 
of data. 

With custom scheduling it can do the same, but it's up to you to 
schedule identical backups on alternating days. If you specify 
an alternate trailset with custom scheduling, make sure to 
define two complete (and exact) schedules, running the same 
level on each of two consecutive days. By scheduling the 
following levels to run on the days shown, you'll create two 
identical trailsets tliat differ by one day's w-orth of data. 



Day 


Level 


Trailset Used 


Monday 


0 


Piimary 


Tuesday 


0 


Alternate 


Wednesday 


9 




Thureday 


9 


Alternate 


Saturday 


9 


Priniai7 


Sunday 


9 


Alternate 
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You can spread out the backups more, as long as you specify 
one of the two identical backups on an even day witli respect 
to die rotation cycle, and one on an odd day. 

Changes to this field take effect the next time ebbackup 
processing runs. 



Use this field to specify the level of logging messages written to 
the file specified via the server log file field when this template 
is backed up. 

Specify the logging level using tliis format: 

logging level: logging level; 

Where logging level is specified as follows (defaults to stats at 
installation). 



Code Description of Messages Logged 

none No messages. 

errors Logs errors, including device and communication errors. 

stats Logs statistics as well as the information for tlte errors ievef 
The statistics include the amount of data saved, the time it 
rook to save the data, when the backup started and 
finished, and so on. 

debug Logs debugging infonnation as well as rlie information for 
the stats level. Only use tliis level at the direction of 
customer support. 

per file Logs several lines, including debug-level information, for 
each file that's backed up. Only use this level at the 
direction of customer support. It slows backup throughput 
and can result in a huge log file. 



Changes to this field take effect immediately, but don't affect 
any currently running work items. 
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Server Log File use this field to specify the name and maximum size of the 

template's log file. This file Ls stored on the server as 
/usr/epoch/EB/log//?fe-?2fl77?£? and records infomiation as 
directed by the logging level field. It provides an audit trail of all 
backup activities for the template. 

The format is: 

server logfile: "log file name", file-size; 
Where: 

• logfile name identifies the log file on the server (stored in 
the /usr/epoch/EB/log directoiy, set initially to 
default_template.log, where "default" is tlie template name). 
You can create a different log file for each template or you 
can share a single log file across all templates, if you specify' 
a separate log file for each template, use a name that 
identifies the template, 

• file-size indicates how large die file can get before the 
oldest data is expired. When die file reaches the specified 
size, EDM Backup locates die oldest data in the file and 
expires 10 percent of that data to free up space for new 
information. Specify this field as a number of bytes 
followed by a unit code (e.g., 500KB, set to 256K at instal- 
lation). Specif^' the unit code as follows: 



Unit Code 


Measure 


k, K, kb, or 103 


kilob)tes 


m, M, mb, oi' MB 


megabytes 


g, G, gb, or GB 


gigabytes 



To allow the file to grow until it's as large as permitted by 
physical storage space, specify no limit (and no odier options). 
By not setting a limit on the file, it becomes a permanent audit 
trail of backup operations for the template: 
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server logfile: "default_template.log", no limit; 

Note: If you don't limit tlie file size, il may become too 
large to manage. Also, in HSM systenxs it won't be 
staged. 

Tliis example logs messages for the sales-all template, and has a 
maximum file size of 256KB: 

server logfile: "sales-all_template.log", 256KB; 

If you omit tliis setting, no log file is maintained for the 
template. 

Changes to this field take effect immediately, but don't affect 
any currently-running work items. 



Backup Completion Script EDM Backup generates completion reports describing each 

successful backup, lliere is one completion report per template. 
EDM Backup forwards these reports to the script file indicated 
using this parameter. The script file, in turn, dispatches the 
reports according to how the script is defined. 

As installed, EDM Backup directs completion reports to 
the supplied "mailok" script on the server 
(/usr/epoch/EB/config,^mailok). Depending on how that script 
is defined, it sends the reports to specific administrators 
(generally those defined in the list of backup administrator 
usernames), to the log file, or to both. 

You can change the script by entering a new script name in the 
Advanced Options popup window in the Schedule tab of the EDM 

Backup Configuration window. 

If you specif)' a relative pathname, the file is assumed to be in 
/usr/epoch/EB/config. If you specify an absolute pathname, the 
file can be located an^'where. 

For a sample report, see "Backup Completion Reports" on page 
16-29. 

If you this setting is blank, no completion reports are generated. 
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Changes to this field take effect immediately. 



Backup Failure Script EDM Backup creates backup failure reports for each work item 

whose backup fails. It forwards tliese reports to tiie script file 
indicated using this parameter. The script file, in mrn, 
dispatches the reports according to how tlie script is defined. 

By default, 1?DM Backup directs failure reports to the EDM- 
supplied "mailerr" script on the server 

(/usr/epoch/EB/config/mailerr). Depending on how that script 
is defined, it mails tlie reports to specific administrators 
(generally those defined in the list of backup administrator 
usernames), to the log file, or to both. 

You can change the script by entering a new script name in the 
Advanced Options popup window in the Schedule tab of the EDM 

Backup Configuration window. 

If you specify a relative pathname, the file is assumed to be in 
/usr/epoch/EB/config. If you specify an absolute pathname, the 
file can be located anyAvhere. 

Eor a sample report, see "Backup Failure Reports" on page 
16-31. 

If this setting is blank, no failure reports are generated. 

Note: You can leave this field blank to reduce the amount 
of EDM Backup mail. Tlie backup completion script 
(jnailok) reports include all types of activity, 
including failures. You can refer there for infor- 
mation about failures. 

Changes to this field take effect immediately. 



Else this statement if you've purchased HSM, and want to ensure 
that all baseline backups finish for the template before the level 
0-9 backups start for any work items backed up by the 
template: 



Do All Baseline Backups 
Before Normal Backups 
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do all baseline backups before normal backups; 

This feature is useful when baseline backups consume most of 
die server's resources, which can happen if significant amounts 
of magnetic disk space are required to hold temporary files. It 
can also alleviate disk tlirashing. On the downside, it can slovv' 
overall throughput. 

With tliis statement omitted (the default at installation), EDM 
Backup finishes the baseline backup for each work item before 
starting the level 0-9 backup for that same work item. 

Note: This specification applies for custom and automatic 
scheduling, but is not used for command-line sched- 
uling. 

Changes to tliis field take effect the next time ebbackup 
processing runs. 



Recreate Baseline if Needed include this statement if youVe purchased IISM, and you want 
to automatically re-baseline any file for which the existing 
baseline copy was substituted for the staged copy during a 
restore: 

recreate baseline if needed; 

If you don't want to re-baseline files automatically, use the 
following statement instead (or don't include either statement). 
This is tlie default setting at installation: 

do not recreate baseline if needed; 

If you choose to re-baseline files automatically, ebbackup 
checks each file when it ams a baseline bacloip, to see if the 
staging id in the file's extended inode is the same as the 
baseline id. These two ids are only the same if the baseline 
copy of the file was substituted for a missing (or damaged) 
staged version. If the ids are tlie same, ebbackup automatically 
generates a new baseline copy of tlie file, then updates the 
baseline id so that it points to the new copy. 
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Changes to this field take effect the next time ebbackup 
processing runs. 



Schedule Tlie schedule tells EDM Backup when to run backups for the 

template, and how much time to commit to backup processing 
each day. For custom scheduling, it defines when to run each 
backup level (and optionally, when to run each level for a 
specific wo?'k group). 

Some scheduling options apply for automatic scheduling and 
some for custom scheduling, as follows: 



Table B-6 Scheduling Fields 



Option Applicable for: 





Automatic 


Custom 


Standard rotations 




no 


full during weekends rotations 






Weekday backup shift 


yes 


no 


Weekend liackup sliift 






[for ivork-group-name] level n on days 


no 


yes 



The schedule block looks like this: 

schedule : 
{ 

/* standard rotations; */ 

/* full during weekends rotations; */ 

weekday backup shift is 8 hours; 

weekend backup shift is 24 hours; 

level 9 on Monday, Tuesday, Wednesday, Thursday, 

Friday; 

for "sales", level 0 on Saturday; 
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for "local", level 0 on Sunday; 

} 

Note: A level map takes precedence over any scheduling 
defined using this block. For example, if you'd 
normally create one level 0 backup and the rest 
level 9 backups during the rotation (as for automatic 
scheduling), but a work item specifies a level map 
of "BBOOOOOOOOOO", each level 0-9 backup for that 
v.'ork item will run as a level 0 backup. 

Specify each field as described below, hi general, tr\' to 
schedule backups when system use is low. 



Standard vs. Full-Durlng-WeekendS Most sites let EDM Backup schedule backups automatically, 

Rotations based on the settings in the configuration file. If tliis is die case 

at your site, choose one of these two scheduling directives to: 

• Turn on automatic scheduling (selecting either directive 
does this). 

« Specify how to perform backups. Indicate the statement 
you want by placing comment markers (/* . . . */) around die 
other statement: 

standard rotations; 

/* full during weekends rotations; */ 



Specification Description 

Standard rotations Schedules backups so tliat some portion of 
the clients receive a full backup each day 

Full during Schedules backups so that all clients that 

Vk'eekends rotations i-equire a full liackup receive tliat backup on 
Saturday or Sunday, when possible, with 
any ina-ementals ainning on weekdays 



Changes to tills field take effect the next lime EDM Backup 
schedules work items. 
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Specifying Backup Shifts if you're using automatic scheduling, use these two fields to 

indicate how much time you want to allow EDM Backup to run 
each clay, lliis serves as a guideline, or goal, when EDM 
Backup schedules the work items for backup. Specify the time 
for each weekday (Monday-Friday), then for each weekend day 
(Saturday and Sunday): 

weekday backup shift is hh hours mm minutes; 
weekend backup shift is hh hours mm minutes; 

Specify hh as a number of hours (an integer in the range 1-24), 
and mm as a number of minutes (1-60; include only if 
necessary); 

vjeekday backup shift is 8 hours 30 minutes; 
weekend backup shift is 24 hours; 

Note: The backup shift specifications are not binding, but 
sen'e only as a target for the amount of time 
committed to backup processing each day. 

Changes to tliis field take effect the next time ebbackup 
processing runs. 



If you're scheduling custom backups, use this statement to: 

• Turn on custom scheduling (happens automatically when 
you include one or more custom-scheduling statements and 
you omit bodi statements used to turn on automatic sched- 
uling) 

• Define when you want to i\in the backups, repeating this 
statement as necessary^ to configure your site: 

[ for "work-group-name"] level n on [day(s)] 
days; 

You can specify each work group individually, or you can 
combine tlie work groups for tlie template into a single 
statement. You might want to combine the work groups for one 
or more level(s), but separate them for another level(s): 

level 9 on Monday, Tuesday, Wednesday, Thursday, 
Friday; 



Scheduling Custom Backups (Level n 
on Days...) 



EDM Software Reference 



B-85 

Backup Template Fields 



for "sales", level 0 on Saturday; 
for "local", level 0 on Sunday; 

Specify each syntax field as follows: 

• The /or work-group-name clause applies if the statement is 
for a specific woi-k group, and specifies the name of the 
work group exactly as it appears in the template's work- 
group list (defaults to all work groups in that list if you omit 
this clause). If two statements apply for the same woi'k 
group, EDM Backup uses the most reso-ictive specification 
(the one that's specific to tlie work group). You might use 
one .statement to schedule all work groups, then add state- 
ments for each exception to the "rule": 

level 9 on days 1-14; 

level 0 on days 7, 14; 

for "sales", level 0 on day 1; 

• The level n clause identifies the backup level you want to 
run on the day(s) specified (0-9, Bl, or B2). If more llian 
one level is specified for the same day, EDM Backup 
performs tlie lowest level, numerically (e.g., level 0 instead 
of level 5). 

If tlie template specifies an alternate trailset, make sure to 
schedule two level-0 backups for each work group — one 
on an even-numbered day and one on an odd-numbered 
day, with respect to die rotation cycle. (Remember tliat the 
two trailsets are backed up on alternating days.) 

Note: Specify baseline backups explicitly. EDM Backup 
does not run baselines automatically when you use 
custom scheduling, 

• days indicates the days on which you want to run backups 
for tliis level (and optionally, for this work group). 

Jf you don't request backups for a particular day, EDM 
Backup won't perform backups on that day (for this 
template). 
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Note: If you schedule cuMoni backups, don't .specifs" 
eilher of ihe directives for automatic .scheduling 
(described under "Speciiying Backup Shifts" on 
page B-H 'i ). This causes an error. 

Specify the days as follows: 



Days Description 
Specification 



a single integer To I'epresent that day in the rotation period (1 for 
tlie first day, 2 for the second day, and so foith up 
to the number of days specified in the rotation 
period for the template). 

a I'ange of 'J'o represent a range of days in the rotation period 

integers only for a rotation period this is NOT a multiple of 7 
clays long (e.g., 1-6 for days 1 , 2, 3, -i, 5, and 6). 

name of day{s) To represent a specific day of the week f that is, for 
a rotation period of 7 days or a multiple of 7 days 
long). Spell out the full name of the day (Saairday, 
Sunday, etc.). You cannot spedfs' a range of names 
— each day must be listed separately. 

You can describe a specific occurrence of a day 
within the rotation period, by prefacing the day 
with a number (2nd Saturday, 3rd Monday, etc.). 



Changes to tliis field take effect the next time EDiM Backup 
schedules work items. 



Startup Parameters Use the startup parameters block to specify when to perform 

the first (level 0) backup for a new client. It's important to 
perform the first level 0 backup as soon as po.ssible, because no 
incrementals run until die first level-0 backup is performed. 

This block applies for automatic scheduling only, and is ignored 
with custom scheduling. It looks like this: 

startup parameters: 
{ 

perform initial full backup on scheduled day; 
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/* perform initial full backup as soon as possible; 
*/ 

Specify one of the following in the EDM Backup Configuration 
window: 

• Specify perform initial full backup on scheduled day to 
perform tlie initial full backup on some portion of the 
newly-installed clients each day during tlie first rotation 
period. Tliis setting distributes the work load as evenly as 
possible across the rotation period, and is the recom- 
mended (and initially configured) approach. By the end of 
the first rotation, every client will have a level-0 backup. 

• Specily perform initial full backup as soon as possible to run 
the initial full backup on all newly-installed clients during 
the first backup am after tliose clients are installed. When 
you use this option, EDM Backup perfonns initial full 
backups on every new- client, one aftej" the other. The 
impact on the system is dictated by the total amount of 
client data tliat needs to be backed up. 

You may want to specify perform initial full backup on 
scheduled day when you first configure your system, dien 
change it to perform initial full backup as soon as possible after 
the initial backups are taken (for use as new clients are added). 

With either method, the client gets backed up according to its 
normal rotation schedule after the initial level-0 backup is 
completed. 

Note: This specification only applies for the first backup 
that's mn after a client is installed. ]t has no effect 
on subsequent processing. 

Changes to the .startup parameters block titke effect the next 
time backup scheduling occurs. 
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Files 



During system startup, the Volume Manager starts each Libraiy 
Manager that is specified in the VM configuration file. A Library 
Manager is added to the VM configuration file when you 
configure a library Manager by using the Imconfig utility. 

'I'his chapter provides detailed information about the Volume 
Manager and Library Manager configuration files. 

The chapter contains the following sections; 

• Volume Manage!' Configuration File 

• Library Manager Configuration Files 

See Chapter 17 "Configuring Library Managers" for information 
about U!5ing the Imconfig utility. 
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Volume Manager 
Configuration File 



When you install the software, a default configuration file 
(vm.cfg) is added to the /usr/epoch/etc/vm directoiy. 



EMC sets the recommended values for parameters in the vm.cfg 
file and, in most cases, tliese do not require modification. The 
only time vm.cfg needs to be modified is when you add a 
Library Manager; Imconfig manages this when you run the script 
to configure a Libraiy Manager. 

Figure C-1 provides a sample vm.cfg file. (Note that comment 
lines begin with the * character.) 

Table C-1 describes the parameters and default values in the 
vm.cfg file. 



# The following is a default configuration file for a vmda« 
# 

# Limitations : 

# o LM^HOST must always be localhost 

# o VM_ALLOW_DUP* must always be no 

# o VM_METRIC* are not used yet 

# o VM_LOCAL_ONLY_ACCESS must always say no 

# o VM_AUTH_TYPE may only by RPC_UNIX 
# 

VM_NAME : vm 

VM^ROOT : /usr /epoch/etc/vm 

VM__SYSLOGLEVEL : concise 

VM_WATCHDOG_LMS : yes 
VM_CATALOG__DIR : /usr/epoch/etc/vm 



Figure C-1 



Volume Manager Configuration File 
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VK_ALLOW_DUP_BARCODE_IMPORT : no 
WI_ALLOW_D0P_SEQ_IMPORT : no 
VM_METRIC_INTERVAL : 60 
VMJ'€ETRIC_EXPIRATION : 33 
VM_LOCAL_ONLY_ACCESS : no 
VM_AUTH_TyPE : RPC_UNIX 

# Field for the offline mount user routine for new media request 
VM_NEW_MEDIA__USR_ROUTINE : /bin/true 

VM_VOLFILE_DIR : /usr/epoch/etc/vm 

# The CLOG^SIZE value determines how large the vm' s debugging 

# circular clog size is allowed to be. The circular log or clog 

# file is only written to when the vmdaemon is in debugging 

# mode. A CLOG^SIZE OF 0 MEANS INFINITE, I.E. NOT CIRCULAR 
VIvI_CLOG_SIZE : 104 857 60 

# The VM__EPJ\SE_LIMIT controls if and how the vmdaemon limits 

# the number of concurrent volume erases per library unit. 

# NONE : no lim.it on the number of concurrent volume 

# erases in an LU 

# NUM_DRIVES : concurrent erase daemons are limited to the numiber 

# of drives in the LU containing the volumes. 

# HALF_OF_DRIVES : concurrent erase daemons are limited to half of 

# the number of drives in the LU containing the volumes. 

# If the number is odd, it will be rounded up. 
VM__ERASE_LIMIT : NOM_DRIVES 

#The VM_FIND__AVAIL_MEDIA_INTERVAL determines after how many 

# VM activities search for available media will be done. 
VM__FIND__AVAILJviEDIA_INTERVAL : 25 

VM_DUP__NUM_ACTIVE : 1 
VM_DOP_STATE : enabled 
VM_DUP_TAPE_PAD : 10 
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#BEGIN_offline_0 
LM__START : 0 
LM_NAI4E: offline_0 
LM_HOST : edmdoc 
LM__EXEC_OPT : "" 
LM_EJECT__DEST : offsite^O 
LM__END : 0 
#END_offline_^0 
#BEGIN_offsite_0 
LM_START : 0 
LM_NAME: offsite_0 
LM_HOST : edmdoc 
LM_EXEC_OPT : "" 
LM_EJECT_DEST : offline_0 
LM_END : 0 
#END_offsite_0 
#BEGIN jntin_^x7 00_0 
LM_START : 0 
LM_NAME: qntm_x7 00_0 
LM_HOST : edmdoc 
LM_EXEC_OPT : "" 
LM_EJECT_DEST : offline_0 
LM__END : 0 
#ENDjntm_x700_0 
# BEG IN_hp_c 1 7 xx_0 
LM_START : 0 
LM_NAME : hp_c 1 7 x x_0 
LM__HOST : edmdoc 
LM_EXEC_OPT : "" 
LM_EJECT_DEST : offline_^0 
LM_END : 0 
#END__hp__cl7xx_0 
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Table C-1 




Volume Management Configuration Parameters 


Parameter 




Description 


VM 


NAME 




Identifies the name of the Volume Manager. The default Ls vm. This 
name is used in system log messages to identifv' the process that 
generated the message. 


VM_ 


.ROOT 




Identifies the full pathname of the vmdaemon. The default is set to 
/u sr/epoch/etc/vm . 




.SYSLOGLEVEL 


Sets the logging level. 'I'he default is concise, which logs only critical 
messages. 

Note: Tiiis setting is overridden at system startup. 




.WATCHDOG. 


.LMS 


Enables the vmdaemon to monitor all Librai'y Manager daemon (Imd) 
processes and to restait any that fail. Tlie default is yes. 


VJVt 


.CATALOG_DIK 


Specifies the location of the volume and template catalogs. Tlie 
default is /'usr/epoch,/etc/vm. 


VM 


.ALLOW_DUP 


_BARCODE._lMPORT 


Detennines whether duplicate barcodes are allowed within a seiver. 
The default is no, which does not allow you to import a \'olume if the 
same barcode ID is already in the volume catalog. This ensures that 
all barcoded volumes remain unique witliin a seiver. 


VM. 


.ALLOW_DUP 


_SEQJMPORT 


Detennines whether duplicate volume sequence numbers are allowed 
within a seiver. The default is no, which does not allow you to import 
a volume if the same volume sequence number is already in the 
volume catalog. This ensures that all volume sequence numbers 
remain unique within a server. 


VM_ 


.metric^mf: 


ERVAl. 


Specifies the frequency, in seconds, that the vmdaemon I'ecords 
metrics. Metrics enable you to gather performance results for use in 
trend analysis. For example, the vmdaemon could track mount faults 
once per hour and the data enables you to detennine the peak of 
certain activities. The default is 60; the value is ignored, which 
indicates that no metrics are recorded. 


VM. 


_METRIC_EXPlMTJON 


Specifies the time period, in days, when metric data should be 
expired. The default is 33 days; this parameter is ignored. 
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Table C-1 


Volume Management Configuration Parameters (Continued) 


Parameter 


Description 


VM„LOCAL„ONLY_ACCESS 


Specifier whether the xnidaemon (as an RFC sener) can rec-ei\e 
sen ice requests from RPC clients on the network, l-xaiiiplcs of RFC 
clients include: the EDM Library I'nit Manager GVl. F.DM Baclsup and 
HSM software, and \olume management's CLE 1'hc default is No. 


VM^AUTHJIYPE 


vmdaemon check user and gruu|i permissions lot the session. This 
allows the \mclaemon to restrict functicms to clients. A \alue of 
RFCLNONl- disables checking of pemiissions. 


VM_NEW_MEDIA„USR_ROU'nNE 


Fros icles a place holder for the user script that is executed in response 
to receiving an offline media request for ax ailahle media. This 
user-specified routine is executed once lor each media request. J-or 
example, a user can include sending email upon receiving the request 
in tliis routine. 


VM_VOLEnJLDm 


1-or ILMC internal use only. Specifics the pathname that contains 
pseudo media types. 'J'he default is 'usr/epoch etc '\m. Pseiido media 
ty(X's are created by using files on a traditional filesystem. 


VM_CLOG_SlZE 


Sets the maximum size of the vmdaemon debugging circular log 
(clog) file. The default is l()t8S760 (10 ,\lHj. The'vm'daemon writes to 
this file while in debug mode. 

Note: Debug mode is enabled b)' default at system 
startup. 

Note: E,.MC Customer Senice requires VM (and IM) clog 
files lo debug a problem effectively. It may be 
necessary- to increa.se the size of the clog file to 
prevent the vmdaemon from overwriting the 
contents of this file. 

Note: Setting tlie default to zero i.s not recommended; the 
circular log file will not have any ,si/c limitation, 
which can cause .serious disk space i.ssues. 

To run in debug mode, .start the vmdaemon with the -d option or In- 
sending a special RP(; reque.st to the vmdaemon. CJnce in debug 
mode, the vmdaemon writes to the clog file and continues to wrap 
until it reaches the maximurn specified size. When the file reaches the 
maxmuin-i specified size, the vmdaemon writes to the top of the file. 
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Table C-1 


Volume Management Configuration Parameters (Continued) 


Parameter 


Description 


VM_EJUSE_LIM1T 


Specifies how many drives are allowed to perform volume erasures 
per optical library unit. 

Note: This parameter is ignored for tape media. 
Values include: 

NONE no limit to the number of concurrent volume erasures in a 

HALF_OF_DR]\'1iS limits tlie number of concun-ent volume erasures 
to half of the drives in the libraiy unit. 

NLiM„f>fm'ES (the default) limits the nuinber of concurrent volume 
erasures to the number of drives in the library unit containing 
volumes. 


VM_FIND_AVA]L_MED]A_]N1'ERVAI- 


Indicates that if a queued request exists, a search for available 
volumes from the catalog is made only after eveiy n number of VM 
activities. (However, a search is done immediately after paiticular 
activities such as import, inject, or inventoiy.) 

The default value of n is 25. 


VM_DUP__N LJiVl_ ACT] V E 


Specifies the maximum number of concurrent duplications that can 
run on a system. The default is 1. 

The maximum should be no greater than half the number of drives 
that are available to the duplication. 
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Table C-1 


Volume Management Configuration Parameters (Continued) 


Parameter 


Description 


VM_DUP_S'1'A'1'E 


Specifies wiielher media duplication is enabled or disaliled. The 
default is enabled. This field appears only wlien its default value 
changes. 


VM_DIJP_TAPE_PAD 


Specifies the amount of label padding applied to original volximes 
when duplication is enabled. The range is 1 to 10. where 1 is 10 .MR 
of pad space and 10 is 100 .MB of pad .space. The delauh is 

This held appears only when its tlefault valut changes. 


I.NLS'tAR']- : 0 
L.M_NAM1-:: hp_cl7xx_0 
L\LHOS'l" : fdiiKloc 
LM_HXJiCLf1P'r : 

i.Mj;ii-:(:i-j)i-:s'r : otnine^o 


Configuratif)n parameters for each Library Manager configured lor the 
sen'er. All changes to this portion of vm.cfg are made b\ liiiconfig. 

LM^NA.MF. provides the name ot the libran- unit in the lorm 
inaniifactnrerjihraiy unit tvpe_serial ntiuihpr. 


I..M_F-ND : 0 


i,,\LH<JST specifies the name of the host on which the Librar\- 
Manager daemon resides, 'lire default is the localho.si, 

I..M_I':XI-X;_()PT provides the options with which a panicular Library 
Manager is .started, The default is no \'alue. 

The l,,M_i';ihCr_Dl-\ST specifics the name of the Library .Manager that 
recei\es a \*olume wlien an eject occurs, 'lite eject must always be 
initiated by clicking the Hject button in the PDM Library Unit Manager 
and not iiy the hardware eject button. The \ allies are none. offline_i). 
and frffsite_0. 
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Library Manager 
Configuration Files 



The Imconfig utility creates a separate director)' in 
/usr/epoch/etc/lm for each Library' Manager that you configure. 
The name of eacli Library Manager follows a convention that is 
based on the type of library unit that it supports. 



Library Manager Naming 
Convention 



The Libra ly Manager naming convention is of the forn 

man ufactu rerjn odel_n 

where: 



Two- to three-character alAreviaiion tliai 
identifies tiie manufacairer of ihi- library unit, for 
example, "hp" .stands for HewlHt-Packard and 
"atl" stands for ATI Produas. 

Code (from two to five characters) that identifiet. 
the type r^f library unit, for example. ail_ ni 
.supports ilie hCA. H''52 librar>' units with Di.'f 
drives manufactured 1)y ATi. Products. 

One-digit suffix that Imconfig appends to the 
Library Manager name. I'he suffix lor the first 
Library Manager is 0. 'Ihis number increments b\' 
1 for each Libraiy Managei ol the same t\pt that 
\ou configure, for example, the first Librar\ 
Manager for an A'il 4,'52 DTI, library- unit is 
atl_4'>2jJ and the .second instance is ■d\\j\'^lj. 



The Imconfig utility' copies a template configuration file, 
Ini.cfg, into die subdirectory and niodifies the file based on 
input diat you provide interactively. Imconfig also creates a 
link to the executable file and adds the information about the 
new Library Manager to the Volume Manager's configuration 
file. 
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Library Manager within eacli Library Manager directoiy, Imconfig creates 

Subdirectories several files. During start-up, the Libi-ary Manager reads the files 

in its directory to initialize the libi-ar\' unit that it is managing 
and to set up its internal data sti'uctures. 

Figure C-2 on page C-10 illustrates an example of the Library 
Manager directoiy structure. (Note that though the libraiy unit 
in the example contains four drives, only two appear in the 
example, due to space limitations.) 

Refer to Table A-3 on page A-19 for a description of the files 
that reside in each Libraiy Manager directoiy. 



Sample Library Manager Directory Structure 



/usr/epoch/etc/lm 
\ 



Im.cfg Ini.cfg Im.cfg Im.cfg 

volid.dat volid.dal clog clog 

do dO Imd Imd 

d1 dl liblmjnumber liblm_tn 

1-0 rO lmjN_(ipen lm._is„o 

lmjn_drive_0,dat lm_in_drive_0.dat 

Im Jn_drive_] .dat lin_m_drive_l .dat 

clog clog 

Imd Imd 

liblm_tnumber liblm_tnuniber 

lni_is_open im_is_open 
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Library Manager Configuration Each Library Manager has a configuration file tliat contains one 
ParamSterS parameter and coiTesponding value per line. A delimiter 

separates each parameter from its value; at least one space 
appears before and after the delimiter as shown in the following 
example: 

LM_NAME : atl_452_0 

The configuration file contains parameters that define tlie name 
of the Library Manager, hardware addresses of the library unit 
and drives, and library unit operating features. 

CAUTION: Do not edit the Im.cfg file manuaUy. The 
Imconfig utility makes all modtftcations to 
library Manner configuration files. If you 
need to make additional modifications to 
this file, contact EMC Customer Service for 
assistance. 

Figure C-3 on page C-12 shows an example of tlie Im.cfg file. 
This is the default configuration file for the ATL 4/52 DLT libraiy 
unit. (Note that comment lines begin with the # character.) 

The Im.cfg file is set up during installation. When you change 
the hardware configuration by adding or removing a library 
unit, you need to reconfigure tlie software to recognize the 
change. For directions, refer to Chapter 17 "Configuring Library 
Managers". 

Table C-2 describes the Libraiy Manager configuration 
parameters and default values in the Im.cfg file. 
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Figure C-3 Sample Library Manager Configuration File 

###generated by lmconfig### 

#@@ebegin_nameee@ 

LM_NAME : atl_^452_0 

#@eeend_name@g@ 

LM_INLET : 0 

LM_INLET_STATE 
LM__END__INLET : 0 

LM^INLET : 1 

LM_INLET_STATE 
LM_END_INLET : 1 

LM_INLET : 2 

LM_INLET_STATE 
LM_END__INLET : 2 

LM_INLET : 3 

LM_INLET_STATE 
LM_END_INLET : 3 

#@@ebegin_other@@@ 
LMJv'OLIDJ'lAP : volid.dat 
LM_DRIVE_EJECT_BEFORE__MOVE : 1 
LM_BARCODE_CAPABLE : 1 
LM_AOTO_INJECT : 1 
LM_IESjDN_STARTOP : 0 
LM_IES__ON_INVENTORY : 0 

LM__SCAN_TIME : 5 
LM_MAX_IDLE_TIME : 300 
LM_MAX_RESIDENT___TIME : 7200 
LM_M1N__RESIDENT_TIME : 120 
LM__DRIVE_CLEAN_TIME : 4 00 



: enabled 



: enabled 
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LM___^MOUNT_PRIORITY : 4 
LM_D1SM0UNT_PRI0RITY : 2 
LM_INJECT_PRIORITY : 3 
LM_EJECT_PRIORITY : 5 
LM_INVENTORY_PRIORITY : 12 
LM_MOVE_MEDIUM__PRIORITY : 6 
LM_WR_LBL_PRIORITY : 8 
LM_RD_LBL_PRIORITY : 7 

LM_LU_PHYSLOC : Bl lab 

LM_CLEANER_BARCODE_RANGE : CLN* 

#@@eend_other@e@ 
LMJ>4EDIA_F0RMAT 
#@@@begin_robot@ 
LM^LU : 0 
LM_LU__BOARD : 3 
LM_LU_BUS : 0 
LM_LO_TARGET : 0 
LM_LU_LUN : 0 
LM_LU_PHYS_DEV : 
LM__END_LU : 0 

LM_^PICKER : 0 
LM_PICKER_STATE : enabled 
LM_END_PICKER : 0 

#@@@end_robot@@e 
#@@ebegin__drive@@@ 
LM_DRIVE : 0 

LM_DRIVE_BOARD : 3 

LM^DRIVE^BUS : 0 

LM_DRIVE__TARGET : 1 

LM__DRIVE_LUN : 0 

LM_DRIVE_PHYS_DEV : /usr/epoch/etc/lm/atl__4 52_0/d0 
LM_MEDIA_TYPE : DLT 
LM_DRIVE_STATE : enabled 

LM_DRIVE_ATTR : lin__drive_dirtY_query_able 
LM_IN_DRIVE_FILE : lrB_in_drive_0.dat 
LM_END_DRIVE : 0 



/usr/epoch/etc/lm/atl__4 52_^0/r0 
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#@eeend_drive@@e 
#@@@begin^drive@@e 
LM_DRIVE : 1 

LM__DRIVE_BOARD : 3 

LM^DRIVE^BUS : 0 

LM_DRIVE__TARGET : 2 

LM__DRIVE_H]N : 0 

LM_DRIVE_PHyS__DEV : /usr/epoch/etc/lin/atl_452_0/dl 
LM_MEDIA_TYPE : DLT 
LM_DRIVE_STATE : enabled 

LM_DRIVE_ATTR : lm_dr ive__dirty_query__able 
LM__IN_DRIVE_FILE : lm__in_drive_l.dat 
LM_END_DRIVE : 1 

#@@eend_drive@@e 
# @ @ @begin_dri ve@ @ @ 
LM^DRIVE : 2 

LM_DRIVE__BOARD : 3 

LM_DRIVE_BUS : 0 

LM_DRIVE_TARGET : 3 

LM__DRIVE_LUN : 0 

LM_DRIVE___PHys__DEV : /usr /epoch/etc/lin/atl__4 52_0/d2 
LM_MEDIA_TYPE : DLT 
LM_DRIVE_STATE : enabled 

LM_DRIVE_ATTR : lm_drive_dirty_query_able 
LM_IN_DRIVE_FILE : lm_in^drive__2 . dat 
LM_END_DRIVE : 2 

#@@§end_drive@@e 
#@@@begin_drive@@@ 
LM_DRIVE : 3 

LM__DRIVE__BOARD : 3 

L.M_DRIVE__BUS : 0 

LM_DRIVE_TARGET : 4 

LM_DRIVE__LUN : 0 

LM_DRIVE_PHyS_DEV : /usr/epoch/etc/lm/atl_4 52_0 /d3 
LM_MED1A_TYPE : DLT 
LM_DRIVE_STATE : enabled 

LM_DR1VE_ATTR : lm_drive_di rty_query_able 
LM_IN_DRIVE_FILE : lm_in_drive_3.dat 
LM_END_DRiyE : 3 

#@8@end_drive@@@ 

###completed by lmconfig### 
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Table C-2 


Library Manager Configuration Parameters 


Parameter 


Definition 


LM_NAME : name 


Name of the Library Manager. Tlie LM_NAME appears next to the 
Hbraiy icon in the Library Units and Drives area of the iiDM Lil^raiy Unit 
Manager window. The value is a charaaei' string tliat contains up to 16 
diameters. 


l.M^INLFT : u 

L.\L]NI.1'''1_STAT1', : stale 
LNLENUJNLiri" : 


State of the inlet when the Libraiy Manager starts up. The value is 
enabled or disabled. The relative inlet number is specified bv 
LM_INLET and LMJiND_lNLET and must be the same valued 


1.M_\'(J1JD_MAP -.file name 


Name of the file (volid.dat) that contains a table of the libraiy unit's slot 
contents. Tlie volid.dat file enables the Libraiy Manager to start up 
without taking a complete inventoiy of the library unit. 


LM_DRlVE_EIEC1'_BEFORE„MOVE : , 


n Deteniiines whether hardwai'e needs the volume to be ejected from the 
drive before the robot moves the volume. 

Values for « are 1 (enable, eject needed) or 0 (disable, eject is not 
needed). 


lm_barcodej.:apable : n 


Specifies whether the libraiy unit supports barcodes. The value for n is 
0 (no barcode support) or 1 (barcode support). 


LM_AlITO„lNJECl' : n 


Configures the librars' unit's inlet as automatic or manual 
Values are: 0 = manual inlet and 1 = automatic inlet. 

A manual infet (that is, hardware-controlled) requires tlie user to click 
the Inject button before the robot moves the 
volume fi-om the inlet into the library unit. 

If the inlet is configured as automatic, the Library Manager polls the 
inlet and moves the volume into the library units without an explicit 
command. The time inteival in which tlie inlet is polled is specified by 
the LM_SCAN_T1ME parameter. 


LM_NOJES_.ONLS'rAR'rElF : n 
OR 

LM_:iES_ON_SlARTUP : n 

LlVLNOJES_ONJNVErfrORY : n 
OR 

LM_lES_ON_INVENTORY ; n 


Deteniiines whether hardware checking occurs (e.g., obtaining the 
status of drives, slots, and inlets) at staitup and during inventory. 

If the values of the parameters that contain "NO" are set to 1 or the 
values of the parameters that imply "YES'^ are set to 0, no hardware 
checking occure. 
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Table C-2 


Library Manager Configuration Parameters (Continued) 


Parameter 


Definition 


LM_SCAN_T1ME : n 


liniL- inten al (in seconds) that specifies how often the Lilsran- Managei 
polls its work list (which includes polling inlets, new iec|uests. and 
cancellations); the default is S seconds . 

For automatic inlets, the inlet is polled continuously (3n this inten al. i'or 
manual inlets, the inlet is polled when you click the Inject button. 


LM_MAX_IDLE_TIME ; n 


\la,\inium time (in seconds) that a volume can remain in the dri\e after 
a dismount request is made. The default value for all dri%'es is 300 
seconds {five minutes). 


LM„JV1AX_RES1DEN'01MH : n 


Maximum time (in seconds) that a volume can remain in a drive before 
allowing preemption b\ a volume of the same priority. The default 
value for EO drives is 120 seconds ^rwo minutes). 'I'he delault value lor 
lape drives is 7200 seconds (two hours). 


LM_M1N_1^SIDENT_J1ME ; n 


Vlinijnum time (in seconds) that a volume of a lower priority can be in 
a dri\ e before allowing preemption for a volume of a higher priority, 
I he default \alue is 120 seconds for tape (two minutes). .40 seconds for 
optical media. 


LM_DRlVE_CLEANjriME : n 


fJesignated lime (in seconds) in which to clean a dri\e. 'I'he Library 
Manager .starts verifying whether the cleaning conifdeted afttr this lime 
period elapsed. The default value is 3iK) seconds (5 minutes) oi lOO 
seconds (over six minutes), depending on the type oi drive and librarx 


l.,M„M0lJNT_PR10KriT : n 


Default priority for mount operations, The value is an integer in the 
range 1-16 (the default is where 1 represents the highest priority. 


LM^DISMOUNIIPMORITY ; ii 


Default pilority for disinount operations, 'llic value is an integer in the 
range 1-16 (the default is 2); where 1 represents the highest priority. 


LM_lNJEC'fLPI«OR]TY : n 


Default priority for inject operations, 'llie value is an integer in the 
range 1-16 (the default is 3); where 1 represents the highest priority. 


LM_EJECr_PR]ORn'Y : n 


Default priorirs' for eject operations. The value is an integer in the range 
1-16 (the default is 5); where 1 repre.sents the highest priorit\. 


LMJNVENT0RY_PR10Rm' : ri 


Default priorit)' for mov ement o[)erations. 'Ilie value is an integer in the 
range 1-16 (the default is 12): where 1 represents the highest pricjrity. 
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Table C-2 


Library Manager Configuration Parameters (Continued) 


Parameter 


Definition 


LM_M0VE_MEDlUM_PR10RriT : n 


Default priority for label write operations. The value is an integer in the 
range 1-16 (the default is 6); where 1 represents tlie highest priorit}'. 


LM_WR_LBL„PRIORrn' : n 


Default priorlt)? for label read operations, 'llie value is an integer in the 
range 1-16 (the default is 8); where I represents the highest priority. 


LM_„RD„LBL_PR10Rri'Y : n 


Default priority for inventory operations. The value is an integej* in the 
range 1-16 (the default is 7); where 1 represents the highest priority. 


LM_LlJ_PHYSLOC : string 


Physical location of the libraiy unit, which the user enters while 
running Imconfig. 


LU_CLEANER_BARCOD]LRANGE : 
string 


Cleaner barcode range. If the value is "N/A" or this parameter does not 
appear in the Im.cfg file, no assumptions are made for cleaner 
barcodes. 

If the value is "CLN*," any barcode that begins widi "CLN" identifies a 
cleaner 


LVLMEDLA__l"OR,MA'r : String 


Format of the backup data on the tape. Tlie supported value is "liDM." 


LM_LL' : n 
LVLLl _B()AR1) ; n 

L\LLr_Brs : /; 
Lvi_LrjrARc;rr : n 

LMJ.l'-UiN : n 
1 .iVLLl "_P H ^ 'S J ) 1{V : path 
LM_END_LL' : n 


Parameters between LM_LU and LM_END_LU (except for 
L!\'LLU_PHYS_DEV) that define the system board number, I/O bus slot 
number, SCSI target ID, logical unit number (LUN). All values are 
integers. LM_LU and LMJiND^LU represent the relative library unit 
number and must be tlie same value. 

LM_LU_PEPi'S_13EV pro\'ides the full pathname (in a character string) of 
the physical device node for the library unit. 


LM_P1CKER : n 
LM_PIC'KE]LHTATJ- : slate 

lm_fnd_pi{:ke;r : n 


State of the robot (or robot) when the Libraiy Manager starts up. The 
value is enabled or disabled. The relative robot number is specified by 
LM_P]CKER and LM„END_P1CKER and must be die same value. 


LM_BARC(Jl)E_\'ERn-K:A'r]ON : value 


Specifies whether the barcode should be verified when a 
volume is mounted. The value is ignored. 
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Library Manager Configuration Parameters (Continued) 



MJJRIVI': : I! 
LMJJRIVILBOARD : ;/ 
LM_DRI\-E_Bl"S : n 
LNLDRIVCJFARGET : // 
LNLDR1VE„LL'.\ : ti 
L\LDRI\-ILPH^'S_Dli\' : path 
L.NLMKDlAjn'PK : i-ahie 
I.M_DR]VlLS'rA'l'r 
I \LDRIVl-_A'rrR : 
Li\LlN_DRJVlU*lU 
ND_URrVB : 1. 



LV1. 



/ altic 



■Jile, 



LMJ)RIVlLPin'SJ)F\- : path 



lALMl-DIAJIYPl; : raliw 



Lft'LDRIVE^TATE : value 
LM_DRJVE_A1TR : string 

LM„IN_DRIVE_FILB : name 



LVLDRI\T: and 1 M_I':ND_1)R]\'E represent the relative drive 
and must l)e the bame s aiue. 

LM_DR]\'E_B0ARD defines tlie system brxtrd numl^er, 
LMJ)R]\'i:„Bl S defines the lO bus slot number 
1.MJ)RIVE.JARc;ET is the SCSI target ID. 
l.MJ)RI\'EJ.l'N is the logical unit number U.l'N). 
(Jiher parameters are described below . 



itles the full pathname (in a 
for the dri\e or robot. 



-hara 



r siring) of the physical device 



'hpe of media that the drive supports. To configure a multifunction 
drive, spccih' one L.NLMEDIAJl'V'i'E parameter and value for each 
media type: 

DLT = digital linear tape camldge 
DTP = digital tape format 

Hn'C_S'J'K, HrrC_MA.GS'rAR = half^nch tape cartridge 

EO = erasable optical disk cartridge 

WORM = write once, read many optical disk cartridge 

98'iOs = ? 

State of the drive when the Library Manager starts up. The value is 
enabled or disabled. 

Indicates whether EDM is to detemiine whether a drive is dirty. If titis 
parameter is not set, EDM does not check the drives; you must then 
check tlie drives directly. 



File name of the file that contains information about the contents of the 
drive. ITie default is lm_in_drive_n.dat, where ri is the relative drive 
number. The drive content file is used during start up and is updated by 
the Librar}' Manager each time a volume is moved into and out of a 
drive, if a drive content file does not exist for each drive, the Libi-aiy 
Manager creates one during startup time. 
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Table C-2 


Library Manager Configuration Parameters (Continued) 


Parameter 


Definition 


LM_DRIVE_START_AFl'ER_MOVE : n 


Indicates whether the drive needs to be explicitly started after a volume 
is mounted. 

The default value is 0, no explicit start needed. A value of 1 indicates 
explicit start, 


LM„l^gECIlTIMEOUT : n 


Maximum time (in seconds) that the Library Manager waits for a volume 
to be inserted into the inlet before returning a timeout error. This 
parameter is used only for library units that have software control, 
which LM_lNLET„UNLOCK_NEEDBD specifies. 


LM_ArrR: value 


Defines the Library Manager; value is offline or offsite. This parameter 
applies only to Libraiy Managers without physical libraiy units. 



LM_0FFL1NE_M0UNT_AC110N : Defines the mount action to be taken upon receipt of a volume mount 

lvalue request. The value is: error, which automatically rejects the request, or 

queue, which holds the request in a queue until the request is satisfied 

or manually rejected. 

This parametej- applies only to Liljraiy Managers without physical 
libraiy units. 

LM^OFFLINE_MOllN1llJSl? JUJUTINE Specifies the pathname of a user routine that defines the mount action. 
: path For example, a user j'outine could be written to send a mail message to 

the Dperatoi- when a volume request is made Ibr an offline volume. 

This parameter applies onlv to Libraiy Managers without physical 
libraiy units. 



The LMJNLETJGNORE_ON_OPEN The IAl_INLETJGNORE_ON_OPEN volume enables you to 



Parameter 



re-inject volumes that you just ejected into the library unit 
automatically, by just opening and closing tlie inlet. The default 
For this capability' is 0: 

LMJNLET_IGNOffi_ON_OPEN : 0 



EDM Software Reference 



c-20 



Volume Management Configuration Files 



When set to the default, tliis parameter does not appear in die 
hn.cfg file. However, you can set die parameter to 1, which 
removes this automatic re-injection feature. You must then 
remove media from the inlet and then close the inlet before 
ejected volumes can be re-injected . 

To set the parameter to 1, add diis parameter to the Im.cfg file 
manually, anwhere between "begin_otiier" and "end_other." 
For example: 

#@@ebegin_otheree@ 
LMJ/0LIDJ4AP : volid.dat 
LM_DR1VE_EJECT_BEF0RE_M0VE : 1 
LM_BARCODE_CAPABLE : 1 
LM_AUTO_INJECT : 1 
LM_IES_ON_STARTUP : 0 
LM_IES_ON_INVENTORY : 0 
LM_INLET_IGN0REJDNJ3PEN : 1 



#e@@end_other@@@ 



/usr/epoch/etc/lm/offline_0. Figure C-4 shows the parameters 
that its configuration file contains. Refer to Table C-2 on page 
C-15 for a description of configuration parameters. 



Offline and Offsite Library 

Managers 



The offlme and offsite Libraiy Managers each has its own 
configuradon file. Each Library Manager is described below. 



Offline Library Manager 



The offline Library Manager resides in 
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Offline LM Configuration File 

###generated by lmconfiq### 
#@@@begin_naine@@@ 
LMJWIE: offline_0 

#@@@end_name8@@ 
#@§@begin_other@e@ 
LM__SCAN_TIME: 5 

LM_OFFLINE_MOUNT_ACTION : queue 
LM_OFFLINE_MOUNT_USR_ROUTINE : /bin/true 

#@@@end_other8@@ 
###completed by linconfig### 



The offsite Library Manager resides in 
/usr/epoch/erc/lnVoffsite_0. Figure C-5 shows a sample 
configuration file. The parameter LM_ATTR indicates that the 
Library Manager is offsite, as opposed to offline, llie parameter 
LM_OTTUNE_MOUNT_ACnON is described in Table C-2. 



Offsite LM Configuration File 

###generated by lmconfig### 

#@@@begin_name§@@ 

LM_NM'4E : offsite_0 

#§@@end_name@@@ 
#§@@begin_otheri@@ 

LM_ATTR : offsite 
LM_0FFLINE_MOUNT_ACTION: error 

#@@@end_other@@@ 

###completed by lmconfig### 
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findxcpio 
Directives 



The work item directive specifies whicli filesystems, directories, 
and files to back up on the client, and which to exckide. EDM 
Backup's autoconfiguration feature builds these directives for 
you automatically. 

When backups are run, all directives, which can consist of 
macros, are translated into die expanded findxcpio syntax; the 
findxcpio program scans the client filesystem and reads the 
client data. (Refer to the findxcpio man page for detiiiled infor- 
mation about the command.) 

This chapter explains the findxcpio macros and expanded 
syntax. 

• Work Item Directive 

• Logical Operators 

• Macros 

• Syntax to do Back Up 

• Syntax to not Back Up 

• Evaluation Shortcuts 
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Work Item Directive you can use the work item tab in the EDM Backup Configu- 

ration window to adjust the specification for the directive(s). 
The interface builds the directives for you (with macros). In 
addition, you can also directly specify the findxcpio directive 
in the Work Item Options window which is accessed tlirough 
the Work Item tab in the EDM Backup Configuration window, 
(You can also edit the directives in die eb.cfg configuration file.) 

The general format of the work item directive is: 

vjork item: "work item name", "client name" 
{ 

"files to back up" ; 
'■'other statements" ; 

} 

Tliis statement has tlu-ee fields: 
" Work item name-, specifies a unique work item that 

indicates the client's name and perhaps a set of files to be 

backed up. 
• Client name: specifies the client name. 
» Files to back up: specifies tlie client's files that you want to 

back up. Certain findxcpio qualifiers can be used after tlie 

specif}dng file names, to further refine which files are to be 

backed up. 



LogiCaB Operators The findxcpio qualifiers include logical operators that enable 

you to expand the file specifications with evaluation statements. 
These operators are: 

• -o (or) 

• ! (not) 

• -a (and) 

The -a operator is not required; it is implied when two or more 
evaluation statements occur in a row. 
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EDM Backup provides a set of macros to use in place of tlie 
findxcpio syntax. The macros simplify specifying what files to 
back up and wfiich to skip. They are defined in the startfiiid 
script. 

The findxcpio command uses arguments that are similar to the 
Li nix find command, llierefore, all "DO..," macros must be 
positioned before other macros, such as "PRUNE...'' macros. 

Note: Simpler representations of these macros are 

a^'ailable in the Work Item tab of the EI3M Backup 
Configuration window. 

Table D-1 lists basic macros and their expanded findxcpio 
syntax. In these statements, substitute the name of a filesystem 
forfs. 



Basic findxcpio Macros 


This Macro... 


Expands to this findxcpio Syntax 


I^OO'IDIS 




l-)O^FS/s 


_fs 


DOJ'KVUfs 


_fs 


DO_DlK fs 


Js 


DO_FILE/s 


_fs 


PRLINE_PATH fs 


"\( -patli", Js, "-pmne -o -true X)" 


I^RllNE_DlR/s 


"\( \! -name", _fs, "-prune -o -tme \)" 


PRUNE„FlLE/5 


"\( \! -name", _fs, "-pmne -o -tnie \)" 


LOCAL_FS_ONLY 


"-xdev" 


NO„NES 


"\( -fstype nfs -paine -o -true \)" 
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Each of the following examples shows how to use the macros 
that are listed in Table D-1 in a work item directive: 

• To back up the root (/) filesystem, you enter tlie work item: 
work item: "cadl-all", "cadi", ROOTDIR; 

• To back up the /home filesystem and all files and direc- 
tories under it, you enter tlie work item: 

work item: "cadl-all", "cadi", 
DO_PATH {"/home") ; 

• To skip any files in /tmp, you enter the work item: 
work item: "cadl-all", "cadi", 
PRUNE_PATH { "/tmp" ) ; 

® To back up all filesystems in the root (/) filesystem and to 
skip any NFS files, you enter the work item; 
work item: "cadl-all", "cadi", 
DO_PATH ("/"), NO_NFS ; 

• To back up all filesystems in the root (/) filesystem, and to 
skip any files named core, you enter the work item: 
work item: "cadl-all", "cadi", 

DO_FS ("/"), PRUNE__FILE ( " cor e " ) ; 

• To back up only files in a particular filesystem (for example, 
/usr), you enter the work item: 

work item: "cadl-all", "cadi", 
DO__FS ( " /usr" ) , LOCAL_FS_ONLY ; 
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Combining the macros in Table D-] , EDM Backup provides the 
following compound macros. 


Table D-2 




Compound fmdxcpio Macros (1) 


This Macro... 




Expands to this findxcpio Syntax 


NO_'rMP_FlLES PRUNE. 


.PATH 


("/tmp"), PRUNE J'lLE ( "\-'' ), PRUNE_F1LK ( "\#\''" ) 


nclautomount PRUNE^ 


JWm ("/net"), PRUNE_PA'ri 1 ("/impjnnt"). PRUNE J'ATH ("/nfs") 



Each of the following examples shows how to use tlie macros 
that are listed in Table D-2 in a work item directive; 

• To back up files in the root (/) filesystem, and to skip files 
in the temporaiy directoiy (/tmp), files that end with a tilde 
(~), and files tliat start with a pound sign (#), you enter the 
work item: 

work item: "cadl-all", "cadi", 
DO_PATH ("/"), NO^TMP^FILES ; 

• To back up files in the root (/) filesystem, and to skip any 
files in the /net, /tnip_mnt, or /nfs directories, you enter the 
work item: 

work item: "cadl-all", "cadi", 
DO^PATH ("/"), NO_ADTOMOUNT ; 
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EDM Hsckup 3lso provides ^idclitioiiJil conipound ni micros iliEt 
combine the macros tliat Table D-1 and Table D-2 contain. The 
following table lists the five compound macros and shows theii* 
expanded findxcpio syntax. 


Table D-3 






Compound findxcpio IVIacros (2) 


This Macro... 






Expands to this findxcpio Syntax 


ROO'IIONLY 


DO. 


_PAT 


H("/"), FOCAL_FS_ONLY 


LOCAL^DISK 


DO. 


.PAT 


Hi"/"), NO„AlJTOMOUNT, NO„NFS 


SYSTEJVLFILES 


DO. 


PAT 


HQV /usr"), NO^AU1"OMOUNT, LOCAI.JS_ONLY 


USER^FILES 


DO^MFHC'/home"), NOjnVlP_FiLES, LOCAL_FS_ONLY 


LOCAL_FlLES 


DO. 


PAT 


H("/"), NO„NFS 



Each of the following examples shows how to use the macros 
that are listed in Table D-3 in a work item directive: 

• To back up only local files in tlie root (/) filesystem, you 
enter the work item: 

work item: "cadl-all", "cadi", ROOT_ONLY; 

« To back up all filesystems on a client's local disk, and to 
skip backing up any automounted or NFS filesystems, you 
enter the work item: 

work item: "cadl-all", "cadi", LOCAL^DISK; 

• To back up two local filesystems, root (/) and /usr, and to 
skip any NF'S-mounted filesystems, you enter the work 
item: 

work item: "cadl-all", "cadi", SYSTEM^FILES; 

• To back up only the local filesystem and to skip any 
temporary files, you enter the work item: 

work item: "cadl-all", "cadi", USER_FILES; 

• To back up all filesystems on the local disk, and to skip any 
NFS filesystems, you enter the work item: 
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work item: "cadl-all", "cadi", LOCAL_^FILES ; 



Syntax to do Back Up The findxcpio command options makes it easy to tell EDM 

Backup to search for certain types of files foi- backup. 

When specifying a client backup list, die simplest backup file 
specification is "/" - which means to start at the top of the 
filesystem and back up all files and directories. In addition to "/" 
you can specify other qualifiers to select or deselect files. 

For example, to specify to have the backup program back up 
only files it finds under "/'' that are .c files, you use the -name 
option: 

work item: "cadl-all", "cadi", "/ -name '*.c' "; 

This file specification checks for all .c files. XX-lien EDM Backup 
locates .c files, it backs them up. When EDM Backup finds files 
that are not .c files, it passes over them. Note die use of single 
cjuotes around die *.c expression. The quotes are required 
because the asterisk (*) is a special character to the shell and the 
quotes prevent the * from being expanded prematurely. 

Suppose you want EDM Backup to copy the files that are stored 
on a fileserver that belong to a pardcular user. You use the - 
user option with the name of a user (karen): 

work item: "atlasl", "diskl-all", "/ -user karen"; 

This file specification checks for all files under the / directory 
that karen owns, and backs them up. EDM Backup pas.ses ovei- 
all files that the user karen does not own. 

Similarly, to select files tiiat belong to a particular group, you 
use the -group option. To back up all files that the doc group 
owns on the filesei-ver atlasl, you enter: 

work item: "atlasl", "disk2-all", "/ -group doc"; 
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This file specification checks for all files under die "/"' directory 
owned by members of the doc group, and backs them up. EDM 
Backup passes over all files that members of group dc^c do not 
own. 

To select files for backup tliat contain a ceitain number of 
blocks and tliat have been accessed within a certain number of 
days, use the -size and -atime options. For example, to select 
files that contain 30,000 blocks (512 bytes each) and were 
accessed in tlie last 72 hours, you enter: 
work item: "cadl-all", "cadi", "/ -size 30000 - 
atime -3"; 

This file specification checks for files under the "/"' directory that 
contain 30,000 blocks and were accessed within the last 72 
hours (specified by the value -3 because each 24-hour period is 
represented by a value of 1) and backs them up. EDM Backup 
passes over any other files. 

To select a certain type of file for backup that was changed 

within a ceitain numi^er of hours, use the -type option and the 

-ctime option. For example, to select symbolic links (1) that 

were modified within the last 48 hours, you enter: 

work item: "cadl-all", "cadi", "/ -type 1 -ctime - 

2"; 

Tliis file specification searches for all symbolic links tliat were 
modified in the past 48 hours (specified by the -2 because each 
24-hour period is represented by a 1) and backs them up, 
passing over any other files. 

On an HSM system, to select only staged files (files with a 
staging ID #1 filled in), use the -staged option: 

work item: "cadl-all" , "cadi" , "/ -staged" ; 



Syntax to not Back Up The findxcpio command options make it easy to tell EDM 

Backup to exclude certain types of files from the backup list. 
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Syntax to not Back Up 



For example, if you want to add a check so that EDM Backup 
does not back up a client's NFS filesystems, you add die evalu- 
ation for the filesystem type NFS using the -fstype and -prune 
options. The -fstype option directs EDM Backup to search for a 
particular filesystem t^'pe. The -prune option directs EDM 
Backup not to descend into subdirectories, but continue evalu- 
ating other filesystems for backup. To direct EDM Backup not to 
copy NFS filesystems under the "/" directory you enter: 
work item: "cadl-all", "cadi", "/ \{ -fstype nfs -prune -o -true \)"; 

Note: 'Ihc use of -fstype nfs -prune is nox recommended, 
because it is impossible to pre\'eni an occasicjnal 
descent into an NI-'S filesystem. 'Ihe better approach 
is to specif)' individual filesystems, each with ihe - 
xdev option. 

This file specification checks for NFS files)'stenis. and when 
FD.M Backup finds an NFS filesystem (true) then the e\-aluation 
continues to tiie second statement. %\'hich is -prune, -prune 
always e\aluates to true and causes the search to stop at the 
NFS filesystem mount point, and to .skip o\er it. If the files are 
not NFS (false), the evaluation proceeds to tlie second statement 
(-0 -true), which e-valuates to true and directs EDM Backup to 
copy the files. 

If your site uses automoimt, and you find that you have timeout 
problems using the previous file specification, use tliis syntax: 

rk item: "cadl-all", "cadi", "/ \( -path /net -prune -o -path /nfs -prune -o - 

th \ / tinp_mnt -prune \) -o -true"; 

Note: Although tliis line appears as multiple lines in this 
example, it must be specified on one line in the 
configuration file. 

This file specification checks for files in three paths (in this 
example, /net, /nfs, and /tmp_mnt). When EDM Backup finds 
one of these patlis (true) then the evaluation continues to the 
second statement (-pmne). -prune always evaluates to Q"ue 
and causes the search to stop at the specified path and skip 
over it. 
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Suppose you do not want to back up a client's /tmp and 
/usr/tmp directories in the "/" directoiy. To add checks for these 
directories you use the -path option to specify the pathnames 
to exclude. You specify tlie -o option (meaning or) to direct 
EDM Backup to exclude eitlier directory: 
"/ ( -path /tmp -o -path /usr/tmp \) -prune -o - 

This file specification verifies whetlier the directoiy is /tmp or 
/usr/tmp. If the directory is neither (false) the evaluation stops 
and EDM Backup copies the file to the backup. If tJie directory 
is /tmp or /usr/tmp (Tnie) then the evaluation goes to the 
second statement -prune, which always evaluates to true and 
causes the search to stop at the /tmp or tlie /usr/tmp directory. 

Suppose that in addition to not backing up tlie /tmp or /usr/tmp 
directories, you do not want to back up editor files and core 
files. To .specify' this, you use the -name option to add checks 
for editor files (*~) or core files: 

"/ (-path /trap -o -path /usr/tmp \) -prune -o ! (- 

The first part of the file specification, as explained in the 
previous example, checks whether tlie directory is /tmp or 
/usr/tmp, and does not copy the contents of the directon' if it is 
eitlier directory. The second part of the file specification checks 
for files that have the name *- or core (-name). This statement 
instructs EDM Backup that if the files are not editor backup files 
(*~) or core files (tnie) tlien back them up. If the files are one of 
these {false), do not back them up. 

Suppose you want to instruct EDM Backup not to cross 
filesystem boundaries, which excludes from backup any 
filesystems that are not explicitly listed. You can use the -xdev 
option for this purpose; 

work item: "atlasl", "diskl-all", "/ /usr /homes - 



Note: If NFS timeouts cause backups to fail trv- using tlie 
-xdev switch. 
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Evaluation Shortcuts 



This file specification checks for the specified filesystems (/', 
/usr, and /homes) and instruct EDM Backup not to cross 
filesystem boundaries, and so, to only back up the listed 
filesystems. Because the file specification includes the "/" 
filesystem, it the -xdev switch is not included, EDIVI Backup 
backs up everything in tlie namespace, including NFS-mounted 
filesystems. 



In certain cases, the findxcpio evaluation process can skip 
parts of the file specification in the work item directive, saving 
time and preventing unwanted side-effects. The findxcpio 
program saves time by quickly eliminating directories and files 
that are specified for exclusion from the backup list. In doing 
so, the program avoids unwanted side-effects because it does 
not act upon the second half of the expression. 

Here are tlie two cases when findxcpio does not bother with 
the second half of a directive. 



In directives with an and in the evaluation, if the first statement 
evaluates to false, findxcpio short circuits the evaluation and 
ignores the second half of the directive ( -prune i. 

Consider this work item directive that specifies not to back up a 
client's /tmp and /usr/tmp directories: 

"/ \ (-path /tmp -o -path /usr/tmp \ ) -prune o - 

In the first part of this directive that contains the implied and, 
when findxcpio finds that a directory is not /tmp or /usr/tmp 
(false) til en findxcpio short circuits and does not evaluate the 
-prune option. On the other hand, if the directoiy is /tmp or 
/usr/tmp itnie) then findxcpio evaluates the -prune option. 
(The -o -true statement directs EDM Backup to copy files that 
are not /tmp or /usr/tmp.) 



EDM Software Reference 



D-12 

findxcpio Directives 



True or in directives with an or evaluation (-o), if the first statement 

evaluates to true, findxcpio short circuits the evaluation and 
dcjes not evaluate the second half of die directive. Thus, in die 
following example, if the directoiy is /tmp (true) dien 
findxcpio does not check for the second type of files 
(/usr/tmp), but goes directly to the -prune option; 

work item: "cadl-all", "cadi", "/ \ (-path /tmp -o -path /usr/tmp \)-prune"; 
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Access Control List (ACL) 



allocation request 



archive setting 



autochanger 



Provides an enhanced level of security for UNIX files. An ACL 
extends tlie standard UNIX permission settings beyond owner, 
group, and otlier. An owner of a file can permit or deny access 
to specific users and groups. 

Request for a volume sent by an application. Hie volume 
characteristics are specified in the accompanying volume 
template. 

Sample I I SM watermark setting tliat is intended foi- filesystems 
whose files are written once and rarely, if ever, read. The 
filesystem's data will typically be staged-oiit and rarely, if ever, 
staged back in. This would be the case if large amounts of data 
are gathered every day and quickly "archived" off of the 
magnetic disk. Other sample watermark settings include cached 
setting and random setting. 

Robotic mechanism inside a libi'ary unit that physically moves 
media into and out of slots and drives. Sometimes referred to as 
a "picker" or "robot." 



EDM Software Reference 



automatic scheduling 



backup activity monitoring 



Backup Activity Wizard 



backup catalog 



backup catalog delta 



backup configuration 



Backup Configuration window 



Function that automatically schedules incremental backups as 
well as some full backups in order to back up each work item 
each night. It provides a fiill backup of each work item once 
within tlie rotation period. It attempts to distribute the work so 
that each night's backups will operate for approximately the 
same length of time. See also custom scheduling. 

Allows viewing and management of active, successful, and 
failed work items through the EDM graphical user interface. 

Enables you to start new, queued, or failed backups, stop 
running backups, or manage the backup queue. Access this 
wizard from the EDM Main window. 



Group of related files that maintain a continuing backup history. 
A catalog identifies a backup at tlie file level by recording the 
names and attiibutes of each file on the client system at the time 
of the backup. Backup catalogs also keep track of the location 
of backup data for each file that was selected for backup. 

Contains a condensed backup catalog with infonnation that 
differs only from the previous backup catiilog files. 

Set of parameters on the backup server used to define what 
data gets backed up, when it gets backed up, to where it is 
backed up, how backups are processed, and who can run 
backups and restores. These parameters are edited through the 
Backup Configuration window and stored in the 
/ usr/ epoch/EB/ config/eb .cfg file . 

Window in the EDM graphical user interface for editing the 
backup configuration. 
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Backup Configuration Wizard Enables you to configure a netw-ork, Symmetlix Path, or 

Symmetrix Connect backup of filesystems or a database. It 
supports all clients. You access tliis wizard tlirough the Main 
window of tlie EDM GUI It leads you step-by-step through the 
configuration process. 



backup levels 1-9 Specifies a backup in which EDM Backup copies only those 
files that changed since the last backup of a lower level. 



backup media Media for storing backup data. Parameters for the backup media 
are specified in the trailset and trail of the backup configuration. 



backup saveset EDM Backup creates a saveset record for each work item it 
backs up. A saveset record contains the template name, work 
item name, the backup level, start and completion times, 
expiration times, and the backup trail. The saveset record is 
used to find the volume containing the backup data and tlie 
associated backup catalog. 



backup saveset record Data saved on backup media from a single backup of a single 
work item. 



backup schedule template Specifies all the information about how to perfomi a backup. It 
includes the work group(s) to backup, the rotation period and 
backup shift lengths, the trailsets on which to store tlie backup 
data, and the backup schedule that dictates a backup level for 
each day. See also template. 



backup server EDM server on a network that contains the client, work item, 
media, schedule, and server configuration information. 



backup shift Parameter in the template of the backup configuration. It 

specifies the desired amount of time for backups to run in each 
24-hour period. 
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backup trailset Also called media set. Defines the media trails to wliich the 

backup data is sent and the type of media to use. It also clefines 
how long to save the backup data and its associated elements. 
See also trailset. 



bad file File that changed during backup or a file that is corrupt. EDM 
Backup tries three times before marking a file bad. 



baseline backup With baseline backups, you back up all of your most stable 

files, which, at minimum, consist of all tlie files that are staged 
out to the staging media. From that point on, you perfomi 
backups relative to the l^aseline; tliat is, the baseline backups 
take care of the data that is staged out, wliile the regular 
backups take care of everything else. 



bitfile Uninterpreted stream of b^^es that contains the staged-out 

portion of a file. A single bitfile can hold tlie contents of a single 
client file or the contents of multiple files. A bitfile is uniquely 
identified by a bitfile ID and a store ID. 



bucket When EDM Migration stages out a file, it logically divides the 
file into a number of segments known as buckets, which can 
then be individually accessed. 



bulk staging in HSM, bulk staging reduces each filesystem's magnetic disk 
utilization to a predefined low watermark (LWM), Bulk staging 
is another name for periodic staging. 



cached setting Sample HSM watermark setting intended for filesystems in 

which reads outnumber writes, and a relatively predictable set 
of files are read. Tliis setting takes advantage of migration's 
ability to keep the most recently-accessed files on magnetic 
disk, thus ensuring optimal performance. Odier sample 
watermark settings include archive setting and random setting. 
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catalog See backup catalog and volume catalog. 

cataloged backup Method of backup tliat updates the system administration 

database with information about tlie backup (i.e., the name of 
the template and tlie volume 113 of llie backup volumes). 

client Workstation or fileserver on a network that accesses the EDM 
server to back up and restore frlesystem and database data, and 
optionally, migrate files. 

client software See local client software and remote client soft^'are. 



client store in HSM, a collection of files that have migrated from a single 
netv^'ork client to the EDM server. Tlie client store can reside 
within any stageable filesystem on tlie EDM fileserver. Every 
client store is associated with a store ID and a bitfile ID. 



compaction in HSM, the process of eliminating stale space on volumes in a 
staging trail and consolidating the staged files onto the 
minimum number of necessar)' volumes. Compacted volumes 
can then be erased and reused. 



configuration See backup configuration. 

cross-client restore User-initiated restore of their own backed up files on one client 
to their own directory on a different client. 

custom scheduling Explicitly schedule backups for particular days of the week, 
month, or other schedule period. (As opposed to using 
automatic scheduling, which schedules backups using general 
parameters and processing algoritlims.) 
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data access pattern Refers to the frequency in which staged data is accessed. Data 
access patterns include three categories: archive, random- 
retrieve, and general puipose. 



database work item specifies which client databases you want to back up. You can 
specify which filesystems, directories, files, and raw partitions to 
include or exclude for backup. See also work item. 



day of rotation Rotation option within custom schedule that lets you schedule a 
period that is not a multiple of 7 days, 

demand staging stage-out that occurs when the high watermark is reached, 

device node Special file, located in /dev, that acts as a pointer to a device 
driver. It associates a location, type, and access mode with a 
physical device. 



disaster recovery Recovery procedure for when the backup server's own disks 

crash. Also applies to crashed disks on network clients. In both 
cases, some EDM software might have been lost, requiring extra 
work before performing the data recovery with EDM Backup 
Restore window. 



domain in the GUI, reports can be designed and run for the local EDM 
or for an EDM domain of multiple EDMs. A domain consLsLs of a 
domain master EDM macliine and multiple EDM machines who 
agree to participate. 



EDM (EMC Data Manager) EMC's hardware product for use as the backup seiver. Provides 
network backup and restore witli automated management of 
media. Contains the EDM Backup software and optional HSM 

software. 
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EDM Backup EMC's software module for network backup and restore. Its 

interfaces include the EDM Backup Configuration window and 
the EDM Restore window. 

EDM Backup client Workstation or filesystem on a network that accesses the server 
to backup and restore files. See also remote client software. 

EDM HSM EMC's distributed hierarchical storage management application. 

The product consists of several software modules that support 
local and network migration. 

EDM Migration EDM Migration provides migration services between an EDM 
server and peripheral devices, such as optical or tape libraiy 
units. It also provides HSM services for other file servers and 
workstations on the network. 

EDM transfer protocol The connection metliod, under control of die edmlinkd 

daemon, used by EDM for installing and communicating with 
supported clients. On supported clients (see the current EDM 
Release Notes) this replaces use of remote shell. 

EDM Volume Management Underlying software of tlie EDM Library Unit Manager interface 
that manages volume allocation, drive scheduling, and tracks all 
removable media for EDM Backup and optional HSM applica- 
tions. See also Volume Manager and Library Unit Manager. 

EMC Data Manager (EDM) EMCs hardware product for use as the backup server. Provides 
neuvork backup and restore witli automated management of 
media. Contains the EDM Backup softT?,-are and optional HSM 
software. 

emxattr file HSM extended attribute file. A file used by HSM that contains 
information about files that have been staged out. 
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erasable optical (EO) disk Rewritable storage medium that uses laser technology to write 
data onto the disk. Also refeired to as a magneto-optical disk. 



event-driven staging Mediod of staging tliat reduces a filesystem's magnetic disk utili- 
zation to a predefined low watermark. Event-driven staging 
occurs automatically when a filesystem reaches a predefined 
high watermark (Hm'l). 



expire backups Process that enables old data stored on backup media to be 
oveiwritten with new data, which includes deleting online 
catalogs From the backup server's disks. 



expire catalogs Process that deletes online catalogs fi-om the backup sender's 
disks, which can be done with or without expiring backups. 



expired media "Expired" is the media state that signifies a piece of media has 
exceeded its maximum number of uses. 



explicit staging Metliod of staging that is initiated manually by users who want 
to selectively stage out one or more files as a group. 



fencepost Poition of a file that remains on magnetic disk after the first 
stage out. 



file restore Copies a client's backup files from the backup sei-ver's media to 
the client's disk. 

filesystem Contains the files and directories on each individual disk 

partition. The "filesystem" refers to the overall system directoiy 
tree that merges tliese filesystems into a single liierarchy. 
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filesystem backup Backup of filesystems over the network, using core EDM 

Backup functionality. Backup of data designated by filesystem 
work items. 

filesystem work items Defined unit of data to be backed up, consisting of one or more 
filesystems. Each work item is uniquely named and specifies the 
filesystems to be backed up. 

full backup Copies all the scanned client files, independent of the time of 
their last backup or tlieir location, to the backup server. 

green zone Disk utilization level that is between the low and high water- 
marks. The green zone should l^e large enough to hold the 
average number of disk blocks used in a day including botli 
new files and previously inactive (staged-oul) files that are 
accessed (staged-in). 



Hierarchical Storage Management Collection of tecliniques used to effectively manage a hierarchy 
(HSM) of storage media such as RAM, magnetic disks, optical disk and 
tape, HSM uses techniques such as attempting to keep the most 
frequently accessed ckita on die highest speed media (highest 
speed usually implies highest cost), less frequently accessed 
data on the next highest speed media, continuing with this 
model until the least frequently accessed data is on the lowest 
speed and cost media. 



high watermark (HWM) Preconfigured disk utilization level that, when reached, causes 
HSxM to immediately stage out enough files to secondaiy storage 
to reach the low watermark (LWM). 



import Metliod of moving volumes among servers. Hie volume 

management import process reads the electronic volume label 
and adds it to the volume catalog of the receiving sen'er. 



EDM Software Reference 



10 



Glossary 



incremental backup Backup method that copies only those client files that have 
changed since the previous backup of any level. 

inode UNlX file's directory information, for example its attributes or 
meta-data. 

keyboard focus hidicates the window or element within a window that receives 
keyboard input. 

labeled volume Media tliat has been given a volume label. 

library unit Robotic libraiy unit that automatically manages the placement 
of cartridges. Most libraiy units are equipped with an inlet to 
insert and eject media, robotics to physically move media, one 
or more internal drives, internal storage slots, and in some 
models, a barcode scanner. 

Library Unit Manager Process that manages volumes located in physical libraiy units 
and offline and offsite locations. A library Unit Manager 
manages drive scheduling, volume mounts and dismounts, 
volume injects and ejects, and library unit inventories. See also 
offlinej) and offsite _0. 

Library Unit Manager Part of the EDM graphical user interface that allows adminis- 
window trators to label, allocate, and acquire information atout all 

volumes in use for backup and, optionally, HSM. Stiuted from 
the EDM Main window. 

life cycle of media See volume life cycle, 

local client software Software located on tlie backup seiver tliat scans its disks and 
copies tlie data for backup. See also remote client software and 
server sotWare. 
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local migration 
logical data 
logical unit number (LUN) 
low watermark (LWM) 
manual backup 

maximum concurrent 
backups 

media duplication 
media list 



Staging of filesystenis from the EDM sen'er to a tape or optical 
library. See also network migration client. 

Data that is identified either at the file level (filesystem data) or 
as a database entit>'. 

Last part of a SCSI address (channel, target ID, LUN). LLlNs are 
numbered 0-7. 

Level to which HSM lowers filesystem utilization as tlie result of 
a demand staging run. 

Schedules liackups from tlie command line using the ebbackup 
command and the names of one or more work items or work 
groups. 

Backup configuration parameters for limiting concun-ent 
processing of work items at various points in the system. There 
is such a parameter for: the server software as a whole, each 
trail, local client software, and each remote client software 
(which applies to network backup of filesystems only). 

Feature of the EDM server that enables you to create a duplicate 
set of backup media automatically after each backup session. 

Displays information for each volume that the Library Unit 
Manager contains. By default, the media list includes the library 
unit name, drive, slot number, and volume information (name, 
barcode, and sequence number), and status of volume sched- 
uling. 
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Clia rotation For each trail, a new tape cartridge is started at the beginning of 
a new rotation period. ITiis way, a set of tapes is CTeated for 
each rotation period tliat just holds data from that period of 
time. Each such instance of the trail is called a media rotation. 

media set Set of media. See trailset. 



media type Type of physical storage medium such as digilitl linear tape 
(DLT) cartridge. 



meta key User-definable key that you can map to any key on your 
keyboard. Most X window applications include a default 
mapped Meta key. Use the xmodmap command to display tlie 
key map for your keyboard. 

migrated data Data that USM has moved from one location to anotlier. Other 
terms used are staged data or staged image. 

migration Process of automatically or manually moving data from 

magnetic disk to secondary storage. Migration is synonymous 
with staging. 

migration server EDM with HSM option. Contains the client, W'Ork item, media, 
scliedule, and server configuration information. In addition, the 
Migration Server contains specific watermark information on 
when to stage files out from local storage to other storage media 
(e.g., optical or tape storage). 

network backup Backup of filesystems over die network, using core EDM 

Backup functionality. Backup of data designated by filesystem 



network migration client Workstation or fileseiver on the network that has data managed 
by EDM Migration software. 
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obsolete work items After autoconfiguration, work items (filesystem work items) that 
no longer validly designate a cuiTent filesystem or a raw 
partition. Backup of these work items will fail if they are not 
moved out of a work group and assigned to a template. 

Offline_0 offline Libraiy Manager (offline_0) keeps track of volumes that 
are located outside a physical library unit, usually in a nearby 
storage rack or shelf. A volume logically enters the offline 
Library Managej* when you eject a volume from a physical 
library unit. 

Offsite backup Concept of storing backed-up data in a location outside of die 
building boundaries or the EDM Backup server. 

offsite _0 Volumes that are located in the offsite Libraiy Manager 

(offsite„0) represent tho.se volumes that are located beyond the 
building's boundaries, such as an offsite arcliival location. A 
volume logically enters die offsite Libraiy Manager when you 
eject a volume from a library unit or the offline Library Manager. 

optical disk Less expensive storage medium that uses la.ser technology to 
read and write data. Two types of optical disks are: WORM 
(write once read many) disks and EO (erasable optical) disks. 

PC work item specifies the PC (NetWare, Windows NT, or OS2) or (3penVMS 
client datii you want to back up. You can specify which direc- 
tories and files to include or exclude for backup. See also work 
item. 

periodic staging Scheduled filesystem staging runs that are set via crontab to 

return disk utilization to the low watermark. Periodic staging is 
another name for bulk .staging. 
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pop-up menu Menu that opens when you place the pointer over an object and 
click mouse button 3- The pointer changes to an icon if a pop- 
up menu is available for that object. Pop-up menus appear in 
the browser of the Main mindow and tlie Librajy Units and 
Drives area of the Libraiy Unit Manager window. 



port control Allows you to control the TCP ports used by the EDM to 
communicate witii clients on the othei" side of a firewall. 



prestage reserve Used for files that have been staged out, but also remain on tlie 
system's magnetic space. Tliis magnetic space can be released 
quickly if disk utilization crosses the HWM. 1b allow filesystem 
usage to return to the LWM during a demand-staging event, the 
prestage resen^e is typically the same size, or slightly larger, 
than the green zone. See also ivorking set. 



prestage watermark {PSWM) Predefined level at which HSM begins to stage files out to 

secondary storage. Tlie prestaged files still reside on magnetic 
disk. See also low w^atermark (lAX'M) and high watermark 
(HWM). 



prestaging Process in which files are written to secondaiy storage but their 
space on magnetic disk is not released. To minimize staging 
delays, HSM anticipates staging requLi'ements and prestages 
additional files to allow the magnetic filesystem utilization to be 
lowered quickly if the HWM is crossed or if a demand staging 
run is necessaiy. 



primary storage Main location, usually magnetic disk, for filesystem data storage. 

Magnetic disk storage is an example of primary storage and 
digital linear tape (DLT) is an example of secondary storage. 
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primary trailset Because of the alternate night scheduling feature, it is possible 
for each template to have two trailsets. Therefore, even when 
you do not use alternate night scheduling and tiiere is the only 
trailset, you will see it labeled Primary trailset. In addition, tlie 
name of the default trailset is "priniaiy". 

random setting Sample watermark setting intended for fiiesystems where reads 
outnumber writes, but where the access pattern is random and 
least-recently-used cacliing is ineffective. Tliis would be tlie 
case, for example, in a government records office, where 
several files must be read in from staging media in order to 
analyze a new file. When the analysis is completed, there is no 
need to keep the files on magnetic disk, because the files won't 
be accessed again for an undetermined period of time. You can 
select this setting for fiiesystems that match this random data 
access pattern. Other sample watermark settings include, 
archive setting and cached setting. 

raw partition vSpecial file, located in /dev, that acts as pointer to a device 
driver. It associates a location, type, and access mode with a 
physical device. 

red zone Area on magnetic disk reseived for processes with root 

privUege. This area is used to expand system log files and other 
system files when the filesystem is full. Tlie red zone only exists 
on systems that support minfree. 

Reliability Agent Scanner Daemon Functionality that actually monitors the EDM system; it includes 
(RASD) the rasd script and rasd configuration files. 

remote client software Software located on client which performs network backup of 
fiiesystems on tlie client. Windows NT, NetWare, and OS/2 
backup client software must be installed on the client platform. 
See also local client software. 
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Remote System Monitor (RSM) Sofm^are that polls the rasd„alert file, notifying Customer 
Sen'ice Database when any significant events are detected. 

Report window Part of the EDM graphical user interface that allows users to run 
reports on tlie local EDM or on many EDMs in a designated 
domain. Reports can be set to run automatically and can be sent 
to a printer, a file, or an e-mail address. Started from the EDM 
Main window. 



restore Copies a client's backup files from the backup server's media to 
the client's disk. See Restore window. 



Restore window Graphical user interface for restoring backed up data. Started by 
selecting Restore from the EDM window or tv'ping edmrestore 
on the server's command line. Also for administrator use, it is 
not limited to user-initiated restore from clients of their own 
files back to their own client. If you have administrator permis- 
sions, you can also change destination directories and clients. 
See also cross-client restore and root restore. 



root restore Restore of any backup files or database information belonging 
to any user on the client to any directoiy on the same client. 
Suitable for a system administrator of a single host See also 
cross-client restore and self-service restore 



rotation period Backup configuration parameter in tlie schedule template. The 
period of days during which a full backup will be performed for 
each work item covered by a template (for automatic sched- 
uling). For custom scheduling, it's the schedule period. 
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saveset record Data that is saved on backup media from a single backup of a 
single work item. A saveset record contains the template name, 
work item name, tlie backup level, start and completion times, 
expii'ation times, and the backup trail. The saveset record is 
used to find the volume containing the backup data and tlie 
associated backup catalog. 

schedule in iDackup configuration, a template is set up to specif^' the 
scheduling of backups and die use of media. See template. 

schedule period Backup configuration parametei" in the template. It's the rotation 
period for automatic scheduling. For custom scheduling, it's tlie 
number of days in the custom sdiedule. See also rotation period 
and custom scheduling. 

secondary storage storage medium, such as a DhT cartridge, used as a lacking 
store for the filesystem. See also primaiy stoi-age. 

self-service restore User-iniriated restore from UNIX clients of their own files back 
to their own client and directoiy. See also cross-client restore 
and root I'estore. 



server See backup server or migration server. 



server software EDM Backup, Volume Management, and optional ffSM softw'are 
located on the EDM sen'er. This software configures, initiates, 
and controls backups, restores, and data migration. See also 
remote client software and local client sofr^vare. 

stage In Movement of data from secondary storage to magnetic disk. 

stage out Movement of data from magnetic disk to secondaiy? storage. 
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stageablefilesystem 



stage-in daemon 



staging 



staging targets 



staging template 



staging trail 



stale data 



store ID 



Filesystem configured for migration, A stageable filesystem is 
sometimes referred to as a "filesystem under migration conti-ol." 

Process that stages in files or deletes bitfiles when a staged file 
is modified. 



hi HSM, the process of moving files from one level in the 
storage hierarchy to anotlier; foi" example, from local storage to 
the EDM sen'er or from magnetic disk to optical disk. Also 
referred to as migration. 

Destination for migrated datti. Destinations include volumes, 
staging media, staging devices, and stores. 

File that contains staging parameters for one or more 
filesystems. Each filesystem is associated widi one staging 
template and each staging template can be used by .several 
filesystems. 

One or more volumes that contain staged data for a particular 
filesystem or group of filesystems. Initially, a staging trail 
consists of one volume and grows to several volumes to accom- 
modate the staged data. A staging trail and staging template 
share die same name. 



Data that remains on optical disk or tape after the data is staged 
in to magnetic disk and modified. \¥hen a large number of files 
become .stale, the volume becomes a good candidate for 
compaction. 

Unique code that identifies a client store on the network. 
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System Monitoring Support 
(SysMon) 



Software which conveys the functionality tliat provides system 
monitoring, including RASD (Iteliabilit^' Agent Scanner I^aemon) 
and RSM (Remote System Monitor). 



target ID Middle part of a SCSI address (channel target ID, LIJN). Target 
IDs are numbered 0-7. 

template Also called bacloip schedule template. A set of specifications for 



scheduling backups and use of media. Each template is 
uniquely named and includes a list of work group names, the 
name of the trailset (which defines media use), and scheduling 
parameters, including tlie rotation period for scheduling full 
backups, weekend backup policy, and weeknight backup shift 
lengtlis. 

See also volume template. 



thrashing Unnecessary staging of files and movement of tlie autochanger 
in a library unit. 

trail Serial set of volumes of a particular media type. Each trail of 

volumes is written to over the course of one rotation period and 
then a new set of volumes is started. The trail specification also 
defines how long to save the backup data and its associated 
online catalogs and records. Wliile uniqueness is provided by 
the combination of template, trailset, and trail names, it is 
helpful to give a unique name for each trailset instance. 

trailset Trail or set of trails to which the backup data is written, consti- 



tuting a complete set of full and incremental backups for a 
rotation period. While uniqueness is provided by the combi- 
nation of (schedule) template, trailset, and trail names, it is 
helpful to give a unique name for each trailset instance. Also 
called media set. 
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USername Username on the client that is used by EDM Backxip to execute 
the client softwai-e processing. (Tlie username is "ebadniin" by 
default for all IJNIX filesystems.) 

volume Secondary storage media, such as tape cartiidges, that contains 
a volume label and is entered into the volume catalog. 

volume catalog File that contains information about all removable media that is 
known to the EDM server. Tlie volume catalog holds detailed 
information for each volume including a unique volume 
identifier, media characteristics, and the volume's current state. 

volume ID Unique identification number electronically assigned to eveiy 
piece of secondaiy storage media managed by the server. 

volume label Unique machine-readable code written on tlie backup media 
that includes a volume sequence number, volume stale, volume 
ID, and volume name. All forms of removable media must be 
labeled before volume management can allocate them to an 
application. 

volume life cycle stages through which media (magnetic tapes and optical disks) 
pass in tlie EDM system. New media begins as unlabeled and 
moves to available (ready for general use for any trail) or 
allocated (ready for a particular trail only) depending on \yh\c\\ 
template you choose during the labeling process. Other states 
include: foreign (non-EDM media), uncataloged (labeled on 
another EDM server), erasing (optical disks only), and expired 
(no longer writable, just readable). 



volume management See EDM Volume Management. 
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Volume Manager Central volume management process wltliin EDM software that 
manages all removable media known to an EDM seiver. llie 
Volume Manager maintains the volume catalog and manages 
volume allocation, access, and volume life cycles. 

volume sequence number u nique identification number electronically assigned to every 
form of removable media managed by EDM Volume 
Management. 

volume state specific mode or phase in the media's life c>'cle. See also 
volume life cycle. 

volume template Named template that volume management uses for lateling 
volumes. See also volume label. 

watermark in HSM, preconfigured levels that divide a filesystem into disk 
utilization zones. Watermarks are expressed as percentages of 
total disk space. EDM Migration has three watermarks: high 
watermark, low watennark, and prestage watermark. The 
watermarks define llie yellow zone, green zone, and prestage 
reseive, 

There are three sample settings: archive setting, cached setting, 
and random setting. 

window manager Software tliat enables manipulation of windows. 

work group Set of work items that are to be backed up to tlie same set of 
media. Each work group is uniquely named and includes a list 
of like work items (tliat is, you cannot mix filesystem, PC, and 
database work items in the same work group). 
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work item 

working set 

WORM optical disk 
yellow zone 



Client resource that you want to back up. A resource can be a 
UNIX filesystem, data on a PC server, or an Oracle, Sybase, or 
Informix database. Each work item is uniquely named and 
specifies the filesystems, database, or PC data to be backed up. 
You cannot mix filesystem, database, and PC work items in one 
work group. 

In HSM, the space on magnetic disk between the LWM and the 
non-stageable data. Tiie working set represents the files that are 
accessed in a given period of time. 

Optical disk that does not allow data to be erased or rewritten. 

Space on magnetic disk beuveen 100% capacit\' and the HWM. 
The yellow zone is reserved for processes to use while HSM 
brings filesystem usage back down to the LWM. 
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A 

Access Control List (ACL) 5-8 
activity checklist 13-33 
adding library units or devices 17-1 
allocation. See volumes 
alternate network backups 

online database 6-9 
alternate ti-ailset 3-17, 19-5, B-13. B-59, B-70, B-75, 
B-85 

archival filesystems 11-15 

archive life, of tape and optical media 11-20 

arcliiving EDM system logs 2-7 

ATL StorLink support 1-3 

authorized backup list B-5, B-18, B-19, B-37, B-52 
authorized recoveiy lists B-5, B-19, B-20 
autochanger C-17 

SCSI address C-1 8 
AIJTOCOINTIG 17-8 
autoconfiguration 

client 3-7 
automatic scheduling 5-5, B-82 

alternate u-ailsets B-13, B-76 

backup shift B-1 4, B-84 

computing B-74 

crontab 14-2 



forcing baselines to run first. See baseline 

backups, forcing before levels 0-9 
full during weekend rotations B-83 
initial client backup B-86 
level maps B-46 
load balancing B-43 

mutual exclusion witli custom scheduling 
B-86 

options B-82 

rotation periods B-74 

setting up the initial backup B-1 5 

specifying a baseline witli B-11 

standard rotations B-14, B-83 

starting rotations B-73 

turning on B-14, B-83 

weekend rotations B-14 
automounied files 

timeouts D-9 
autoscheduling 3-7, B-14 

B 

backup 

automatic 14-4, B-4 
baseline reports l6-4 
checking completion of 2-3 
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backup (continued) 

client home director}' A-13 

coordinating with stageout schedules 13-4 

crontab 14-4, B-4 

executing l4-4, B-4 

filesystem 5-7 

high priority 8-11 

incremental 5-7 

installation files A-2 

nightly 14-4, B-4 

processing 14-2 

cjueries 16-3 

reports 3-21 

See also reports 

reuse of baseline volumes 12-18 

schedule 11-22, B-82 

starting 14-4, B-4 
backup account B-5, B-17 
Backup Activity Wizard 1-15, 3-5, 5-5, 14-2 
backup administrator 

recovering files B-19 

recover}' administrator B-23 

user names B-5, B-17, B-79 
backup catalogs 14-9 

changing a filesystem B-3(). B-35, B-49 

changing a work item B-30, B-35, B-49 

compressing B-11, B-58, B-69 

creating 3-11 

deleting incomplete 2-8 

delta level B-11 

distributing among severitl disks 10-10 

expiration period 3-12 

expiring 3-12, 10-4, B-66, B-67, B-68 

locating during recovery B-68 

processing of 20-31 

recreating 10-2 

retention period B-11, B-68 

setting processing schedule 14-9 
backup client cleanup command B-9 
backup client directories A-13 



backup client initialization command B-9 
backup clients B-5 

backing up 5-5 
backup completion reports B-13, B-71 , B-79 

locate failure information B-80 
backup completion script B-79 
backup configuration file B-1 to B-87 

backup template fields B-70 

editing rules B-3 

field summary B-5 

findxcpio macros D-3 

server B-5 

server block fields B-1 6 

server-level configuration fields B-5 

specifying backup files D-7 

trailset fields B-58 

work item fields B-32 
Backup Configuration window 1-17, 3-13, B-1 
Backup Configuration Wizard 3-13, 14-2 
backup coverage reports 16-32 
backup data B-70 

definition of 3-20 

expiring B-65, B-66, B-67 

locating during recovery B-68 

retention period B-65 

storage of 3-11. 5-12 
f3ackup databases 

when to back up 2-10, 13-7 
backup duplicate reports 16-12 
backup expiration 5-19, 5-20 
backup failure reports B-13, B-80 
backup failure script B-80 

backup levels 1 1-34, B-7, B-8, B-10, B-34, B-38, B-45 
alternating trailsets B-76 
autoscheduling 3-7 

baseline level written to a trailset B-11, B-64 
consolidating catalogs B-11, B-69 
custom schedule in eb.cfg B-15, B-82 
custom scheduling B-82 
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forcing baselines to mn first B-13, B-43, B-70, 

B-80 to B-8] 
forcing level 0 B-30, B-35, B-49 
full 3-7, 3-9, 3-11 
incremental 3-7, 3-11, 5-5 
load balancing B-7, B-43, B-54 
mapping B-8, B-45, B-56 
retaining backup catalogs B-68 
retaining saveset records B-1 1 , B-69 
specification in eb.cfg B-84 
specification of the filespec B-37, B-52 
specifying B-6l 

specifying the filespec for levels Bl and B2 
B-7, B-38 

time between flill backups B-1 2, B-74 
trails B-11 

work item options by B-34 

writing a trail B-58, B-60 
backup path 

versus restore patli 5-16 
backup priority B-7 
Backup Report window 16-1 
backup reports 16-1 

See also reports 
l3ackup saveset 3-20 

backup catalog 3-20 

backup data 3-20 

saveset records 3-2(J 
backup schedule B-35, B-42, B-72 

specification in eb.cfg B-82 
liackup server 

backing up all filesystems B-38 

backing up database files B-42 

database files B-46 

directories A-2 

maximum simultaneous client backups B-5, 

B-60, B-62 
name B-5 

priorities and resources B-42 
software files A-2 



backup server log file. See template log files 
backup shifts B-31 

definition B-84 

nightly 3-10 

weekday goal B-14, B-82, B-84 

weekend goal B-14, B-82, B-84 
backup templates B-59 

backing up work groups B-31 

backup completion reports B-79 

efficiency with fewer B-60 

forcing baselines first B-43 

list of fields B-1 2 

mapping levels B-8, B-45, B-56 

naming B-1 2, B-71 

obsolete work items B-35 

removing obsolete B-72 

specification in eb.cfg B-70, B-S4 
backup trailsets 3-3 
backup work groups 3-3 
backup/HSM tug 11-9, B-34, B-39 
backupdates file 11-9 
backups 14-5 

automatic. See nightly backup processing 

Backup Aaivity Wizard 3-5, 5-5, 14-2 

baseline work items 16-27 

command-line 14-7 

configuration window 3-13, B-l 

configuration wizard 3-13, 14-2 

coverage reports 16-32 

database 2-10 

deleting expired catalogs and media 2-^ 
deleting incomplete catalogs 2-8 
disabling client backups B-19 
executing from crontab. See nightly backup 

processing 
expiring 5-19, 5-20, 10-3 
expiring catalogs B-68 
expiring data B-66, B-67 
expiring saveset records B-68 
from crontab 14-5, B-42 



EDM Software Reference 



Index 



backups (continued) 

histoiy 

work items 16-1 6 

interleaving on media 5-12 

load balancing 3-7 

local client 5-2 

log files. See log files 

manual 3-22, 14-7 

modified files 3-1 1 

network 16-37 

NFS timeouts D-10 

nightly processing 3-10 

online 5-7 

priority 5-4, 5-5 

rotation period 3-7 

scheduling 3-3, B-41 

automatic. See autoscheduling 
custom. See custom scheduling 
from command line B-1 

storing 3-11,5-12 

verifying backups 2-8 
backups.log files 5-15, l6-5. 16-35, B-27, B-28 

client B-6 

server B-6 
barcode 

configuration C-15 

inventory 8-21 
ba.seline 

backups 

updating the saveset-to-baseline 
relations database with A-10 

media 11-29 

reports. See reports 
liaseline backups 

active volumes 12-19 

as backup levels. See backup levels 

completeness option with B-8, B-34, B-45 

custom scheduling B-85 

definition 11-33 

expiring saveset records for B-69 



filespec for B-7, B-34, B-38 

forcing before levels 0-9 B-13, B-43. B-70, B-80 to 
B-Sl 

level mapping, and B-47 
level written for a trailset B-ll, B-64 
recreating automatically B-14, B-71, B-81 
trails used for B-60 

updating the saveset-to-baseline relations 
database with 5-3 

with stage-to-tape 11-21 
baseline filespec B-34 

how to specify B-38 
baseline volumes 

deallocating 5-20 
baseline-relative backups 5-20 
bitfiles 12-13, A-24 

l6-digit hexadecimal name 12-13, A-24 

bitfile ID 12-13, A-25 

description of 11 -7 

names 12-13, A-25 

stale 11-30, 13-30 
buckets 12-7 
bulk staging 11-2 

automating 13-2 

stage in 13-9 
byte array. See bitfiles 



cached filesystems 11-15 

candidate list 11-19, 12-5 

catalog disk subsystem 1-9 

catalogs 3-11 

backup. See backup catalogs 
distributing among several disks 10-10 
expiring 10-3 

expiring backups 3-12, 10-3 
processing 20-30 
recreating backup 10-2 
status of processing l6-9 
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volume 7-4 , A-20 

volume template A-2() 
checklist for port control 4-10 
circular log files 15-4, A-19 
cleaning cartridges 

default barcode 8-10 

injecting into libraiy units 8-10 

maximum usage count 8-10 

usage count 8-1 1 
cleaning tape drives 2-9 
client account B-5, B-17 
client agent. See emsd 
client backup username B-5, B-17 
client directories A-13 
client log files 16-37 
client pacing 5-11 
client recoveries 

authorizing B-5, B-19. B-20, B-23 
client rotations B-12, B-74 
client softm?are 3-2, 5-6 
client stores 11-4, 11-6 

bitfiles 12-13, A-24 

changing name of 13-16 

changing ownership of 13-16 

clearing incomplete bitfiles 2-9, 13-31 

creating 13-32 

directoiy tree 12-12, A-23 

future needs 11-9 

how many to create 11-7 

ownership 11-7 

removing 13-32 

when to back up 13-7 
client-'seiver architecture 3-2 
clients 

-ebadmin login A-13 

autoconfiguring 3-7 

backing up 3-11, 5-5 

backing up filesystems 3-6 

backup installation A-13 

client pacing 5-10, 5-11 



database 5-4 
disabling backups B-19 
IBM ACLs 5-9 
local backup 5-2 

maximum simultaneous backups B-5, B-24, 
B-62 

maximum simultaneous backups per trail 

B-ll,B-60 
multiple networked B-40 
Net\%re 5-4 
new- 
scheduling first backup B-15 
NFS filesystems D-10 
platforms A-6 
restoring data 3-12 
unavailable during backup 5-5 
work groups. See work groups 
work items. See work items 
command-line interface 14-7, 18-1 

See also scripts, manpages 
command-line scheduling B-65 
commands 
backup 

eb_servcr_config B-17 

ebbackup 2-8, B-4, B-17, B-41, B-71. B-81 

ebimport 10-14 

ebrestore 5-l6, B-24, B-28 

ftndxcpio 5-7, B-7, B-8, B-10 

startfind 5-4, 5-7 
recover 

ebrestore B-20, B-22 

ftndxcpio B-37 
restore 

edmrestore 5-18 
compaction 13-6 

administering 11-28, 13-29 

baseline 11-29, 13-30 

baseline volumes 12-18 

coordinating with backup and HSM 13-5 

dbreport 13-19 
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compaction (continued) 

description of 2-6, 11-27 

disabling 13-26 

emxattr file 11-27 

goals 12-14 

limits 13-7 

manual 11-27. 13-28 

report 11-30 
completeness option 5-5, B-7, B-34, B-45 

defining 11-34, B-44 

staged files, with B-43 

with baseline-relative backups B-45 
completion reports 16-4, 16-29 

See also backup completion reports 
concise log 15-3 

conf_ism_staging_teinplate. See emstconf 

configuration 

autochanger C-17 
barcode C-15 
client 3-7 

database (HSM) 12-2, A-21 
default backup 3-7 
default trail 3-7 
EDM Symmetrix Connect 6-15 
logical unit number C-17 
of Libraiy Managers 17-1 to 17-14 
watermarks 11-10 
configuration files 
backup B-1 to B-87 

See also backup configuration file 
eb.cfg A-8 

Library Manager C-9 
Im.cfg A-19 

server block fields B-1 6 
syslog 15-6 
Volume Manager C-2 
work group fields B-31 
connection 

connection via B-7, B-40 

use connection method B-9, B-57 



convenient property 13-10, 13-24 

stageout 11-23 
coordinating HSM and backup 11-22, 13-5 
coverage reports 16-3, 16-32 
crash files 

deleting 10-4 
creating 

space on magnetic disks 10-13 
cron 2-6, 13-31 

autocompaction 12-15 

backup process 3-10 

message logging system 2-4 

periodic staging 11-22 

See also command -line backups, crontab, nightly 
backup processing 
crontab 14-5, 16-26 

adding entries from the EDM GLU 2-6, 14-4 

backup 14-4, B-1, B-4, B-38, B-42 

backup catalogs 14-10 

file 14-4, 20-5, 21-2 

message logging system 15-2 

nightly backup 14-2 

reports 16-1 
crontab file 

deleting existing entries 2-9 
cross recovery B-5, B-20 
current stiiging volume 11-4, 13-19 
custom schedule 3-17 
custom scheduling B-65 

alternate trailsets B-76, B-77 

establishing the schedule B-1 5, B-84 

executing backups 14-6 

forcing baselines to mn first. See l^aseline 
backups, forcing before levels 0-9 

level maps B-46 

mutual exclusion with automatic scheduling B-86 
options B-82 

rotation periods B-74, B-86 
starting rotations B-73 
turning on B-1 5, B-84 
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D 

daemon processes 12-9 
daemons 

ebbackupd 14-9 

ebcatalc^d 5-3 

Library Manager 8-4, A-19 
notd 8-4 

Volume Manager 8-4, C-5 
daily log 

distribution list 2-4 

syslog 15-3 
daily tasks 2-2 

damaged disk, replacing 21-1 
database 

backup levels B-47 

EDM Symmetrix Connect clients 6-6, 6-7 

EDM Symmetrix I^ath 6-2, 6-12 

EDM Symmetrix Path clients 6-3, 6-6, 6-7 

files 2-10 

network 6-2 

online network 6-2 

online neuvork clients 6-3, 6-6, 6-7 
database backups 6-2 

backing up client 3-11 

restoring 5-18 
dbreport 11-27, 11-30, 13-19, 13-28, 16-34 

compaction report 13-7 
deadlock potential 

with stage-to-tape 11-21 
debug logging level 15-3, B-77 
debug mode 

volume management C-6 
deconfiguring a Libraiy Manager 17-14 
default clemer barcode 8-10 
default configuration 

backup 3-7 

trails 3-7 
default_template.log file 16-36 
delay factor 11-22 



deleting expired catalogs, media, and saveset 

records 2-8 
delta catalog 10-8 
delta inventory 8-21 

delta level. See backup catalogs, compressing 
demand stageout 11-2, 11-12 
detail log 15-3 
device drivers 
adding 17-1 
installing 17-4 
removing 17-7 
updating 17-6 
device node C-17, C-18 
df 13-18 
directories 

backing up client 3-11 
client A-13 

-ebadmin A-13 
bin A-16 
EB A-15 
EBJ3B A-16 
home A-13 
man A-16 
HSM A-21 
server 
bin A-5 
catalogs A-5 
client A-6 
config A-8 
db A-9 
locks A-10 
man A-10 
preconfig A-1 0 
VM A-2 
disabling staging 13-24 
disaster recoveiy 20-1 to 20-33 
an example 20-2 
client restore 21-1 to 21-6 
disabling backup commands 20-5, 21-2 
hardware 20-6 
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disaster recoveiy (continued) 
HSM local configuration 20-18 
libi-aiy manager configuration 20-1 1 
preparation for 19-1 to 19-6 
restore LOCAL_DATABASE 20-15 to 20-22 
software 20-6 
strategy 19-2 

using duplicate volumes 20-21, 20-23 
disaster reports 2-5, l6-4, 16-19 to 16-26, 19-4 

disk configuration 20-7 

installation report 20-9 to 20-11 

vfstab 20-8 
disconnecting library units 17-14 
disk capacity 

monitoring 10-5 
disk crash 

client recovery 21-2 
disk thrashing B-81 

disk thrashing, preventing. See exclusion tags 
disks 

backing up magnetic 3-10 

capacity 10-5 
DLT media 8-27, C-18 
do not load balance field B-7, B-34, 
B-54 

drive cleaning 8-22 
drive preemption 8-1 6 
drives 

busy 8-11 

contents file A- 19 

preempting 8-16 

scheduling 8-16 

SCSI address C-18 

See also tape drives 
DTF 8-27 

duplicate command options 16-13 
duplicate volume sequence numbers 8-26 
duplicate volume states 9-28 
duplicate volumes 7-5 

in disaster recovery 20-23 



duplication state 16-12 
duplication status 16-12 

E 

eb_server_config 5-14, 20-11, 20-13, B-17 
ebadmin client backup user name B-5, B-17 
ebadmin login A-13 

ebbackup 2-8. 5-3, 5-4, 5-13, 5-14, 10-3, 13-7, 14-7, 

21-2, B-4, B-17, B-41, B-71, B-81 
ebbackupd 5-3, 5-4, 5-12, 5-14, 5-15 
ebcatalogd 5-3, 5-13, 14-9, 20-16, 20-22 
ebcatclean 2-8, 21-2 
ebcat.log file 16-5, 16-36 
ebcatproc 20-31 
eb.cfg file A-8 

backup. See backup configuration file 
ebcp 13-14 to 13-18, 13-27, 13-32 
ebcrecover 5-17, 18-3 
ebexpire 2-8, 10-4, 10-14, 12-19, 21-2 
ebfs_import 13-15 
ebimport 3-21. 10-14, 20-16 
ebrecover 5-17, 18-3 
ebreport 9-25, 10-8, 16-4 to 16-35 

backup 16-6 to 16-9 

baseline 16-27 to 16-29 

coverage 16-32 

disaster 2-5, 16-19 to 16-26, 19-4 
2-8 

duplicate 16-12 

history 2-3, 2-8, 10-11, 16-15 to 16-18 
media 2-8, 16-10 to 16-11 
run from cron 2-8 
ebreport coverage 16-32 

ebreport duplicate 9-25, 9-27, 16-12, 16-13, 16-14 
ebreport history command options 16-16 
ebreport media 9-25, 9-29, 16-10 
ebrestore 5-13, 5-l6, 13-34, 13-35, 13-36, 14-9, 16-5, 

18-2, 18-3, 18-5, 20-19, 2028, 20-29, 20-30, 

20-31, B-20. B-22, B-24, B-28 
ebseiver field B-5, B-17 
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grapliical user interface (GUI) 1-12 

hardware 1-9 

internal components 1-9 

oveiview 1-3 

software 1-1 1 
EDM Library Unit Manager 7-3 
EDM Migration 

determining backup status for clients 5-3 
EDM Migration clients 

completeness option with B-34 

work-item options for B-34 
EDM Symmetrix Connect 1-6 
EDM Symmetrix Patli 1-5, 6-2, 6-12 
edm_ser vices 

files 4-14 
edmcrestore 3-12, 5-17 
edmproc 8-5, 8-7 
edmremote 1-13 
em_make_cl 12-4 to 12-6 
embsi 11-2, 12-7, 13-9 
emcheck 11-31, 13-12, 13-33 
emchmod 11-23, 11-25, 11-26, 12-7, 13-10, 13-24 
emcompact 2-7, 11-27, 12-14, 13-5, 13-28, 16-35 
emdu 13-18 
emfind 12-7 

emfsconf 11-22, 12-2, A-21 

emfsreport 13-19, 13-20 to 13-22, 13-26 

emls 11-23, 11-24, 12-7, 13-2, 13-10, 13-18 

emlsconf 20-17 

emmasterd 12-4 to 12-5 

emscheck 2-9, 13-31 

emschs 1 3-1 6, 1 3-31 

emsd 1 2-9 

emsid 12-7 

emsmks 13-32 

emsmvs 13-16 

emsstat 11-31. 13-32 

emst^e 11-2, 12-7, 13-2, 13-9 

emstconf 12-2, A-21 



emsundel 2-9 
emsysconf 12-2, A-21 
emvck2-7, 11-28, 13-5, 13-6, 13-29 
emxattr file 1 1-27 
epcleanup 2-8, 10-4, 10-15 
epnewlog 2-7 

Epoch Bitfile System (EBFS) 8-3 

Epoch \blume Management, See volume 

management 
eptrunclog 2-7 

erasable optical (EO) media 8-27, C-18 
erasing, volume state 7-7 
error logs, rotating 1 3-8 
error messages 15-1 

format 15-5 

logging level B-77 
evmchvol 8-11 
evmclean 2-9, 8-22 
evnumport 8-9 
evminject 8-1 0 
evminventory 20-19 
evmlistd 8-3, 8-26 
evmstartup 20-22 
evmstat 8-3 

exclusion tags 5-5, B-7, B-34, B-40, B-53 
expiration 3-20 

backup 5-19, 5-20 

backup catalogs 3-12, 10-4, 10-14 
expired media 7-6 
expiring backups 10-3 

F 

failed backups, reprocessing 14-7 
failed duplications 9-19 

removing from the queue 9-18 

vmdup -remove 9-18 
failure reports l6-2, l6-4. 16-31 

See also backup failure reports 
features 

EDM Symmetrix Connect 1-7 
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fcncepost 11-24, 12-6 

file control properties 11-23, 13-10 

listing and changing 11-24 
file locking 11-23, 11-24, 13-12 
file names 

/usr/epoch/man A- 13 

/usr/man A-13 

-ebadmin A-13 

-ebadmm/client-name/bm A-1 3 

-ehadmin/client-naiiie/iUSTORY A-1 3 
file properties 

staging control 11-23 
file recoveiy 3-12, 5-16, B-16 

catalogs B-68 

commands. See commands, recover 
completeness options, and 11-35, B-34, 
B-45 

enabling B-5, B-19. B-20, B-23 
logging B-28, B-29 

recoveiing another client's files. See cross 

recovery- 
time vs. rotations B-74 
using a baseline for B-14, B-81 

file i-ecoveiy commands 
ebrestore B-24, B-28 

file serial numbers. See inodes 

files 

automounted D-9 

backing up client 3-1 1 

backing up modified 3-11 

circular log A-1 9 

daily changes 10-7 

deleting tmp and cra.sh 10-4 

determining number of backed up 10-9 

drive content file A-1 9 

eb_ci_data A-7 

eb_ci_particulars A-7 

cb.cfg A-8. B-1 to B-87 

excluding from backup D-8 

Library Manager configuration C-9 



Im.cfg A-19 

log 15-2, 15-4 

recovering 5-1 6 

recovering client 3-12 

scanning client 5-7 

specifying for backup D-7 

specifying with findxcpio D-7 

staging control properties 11-23 

volid.dat A-19, C-15 

volume management A-1 8 

Volume Manager configuration C-2 
filespec B-8, B-34 

specifying B-37, B-52 

to back up B-37 
filesystem delay 11-22 
filesystems 

archival use 11-15, 13-20 

backing up client 3-6, 3-11 

cached 11-15 

cleaning up 10-4 

delaying stageout 11-22 

exceeding HWM 11-12 

exceeding PSWM 11-11 

general puipose use 11-15 

limits 11-18 

populating 13-23 

random use 11-16 

sctnning 5-7 

with many small files 11-19 
findxcpio 5-3. 5-7, B-7, B-8, B-10, B-37 
findxcpio macros D-3 
firewall 4-5 
Flags column 11-24 
foreign volumes 7-6 
freezing a client store 13-31 
full backups 3-7, 3-9, 3-11, B-63 

avoiding extra B-7, B-43, B-54 

performing initial B-1 5, B-86 

rotations B-1 2, B-74 



EDM Software Reference 



11 



Index 



uncompressed catalogs B-70 

week or weekend B-14' 
llill filesystems 11-10, 13-19 
fiisef 1 5-4 

G 

graphical user interface (GUI) 1-14 

H 

hardcopy documentation xxxi 

hardware 

configurations 6-1 5 
repkace after a disaster 20-6 
SCSI address 17-^i 

hardware address configuration C-18 

high watermark 11-2, 11-18, 13-25 

history reports l6-4, 16-15 to 16-18 

HTTC 8-27 

HSM 

activity checklist 2-2 

client installation 1-21 

Configuration window 1-22 

disabling 13-25 

performance factors 11-5 

procedures am via cron 2-6 

staging to tape 13-3 

support 1-8 

volume labels 7-8 
HSM backup tags A-10 
HSM directories A-21 



I/O daemon (iod) 

circular log file 15-4 
importing volumes 8-9 

importing duplicate volumes 8-9 

media information 8-10 
incremental 5-7 



incremental backups 3-7, 3-9, 3-11, 5-5, 5-7 
expiring catalogs B-68 
mapping B-48 

maximum concurrent clients B-63 

week day B-83 
inheritable properties 11-23, 11-25 
initiating manual duplication 9-8 
inject 8-11 

injecting cleaning cartridges 8-10 
inlet configuration C-15 
inlet types 

automatic 8-8 

manual 8-8 
inodes 11-19 

information about 13-18 
Install Wizard 1-15 
installation report 20-9 
interfaces 1-13 

recoveiy 20-22 
interleaving backups 5-12 
inventories 

delta 8-21 

library unit 8-20 
invenloiy methods 

verify barcode 8-21 

verify label and barcode 8-21 
inventor)'- table 8-19 
ism_compact command 21-2 

K 

keep backup catalogs B-68 

keep backup catalogs specification 10-3 

vs. rotation period 10-5 
keep backups specification 10-3, B-11, B-65 
keep property 1 1-23 

keep saveset records specification B-ll, B-68 

kernel messages 15-5 

key processing concepts 3-3 



EDM Software Reference 



12 



Index 



L 

labels 

volume 7-4, 8-12 
level 0 backups. See full backups 
level 9 backup. See incremental backups 
level map B-8, B-34 

precedence over schedule block fields 
B-83 

specifying B-45, B-56 
levels. See backup levels 
Librar\' Managers 

circular log file 15-4 

configuration files C-9 

daemon 8-4, A- 19 

deconfiguring 17-14 

drive preemption 8-16 

icon 7-12 

initial staiuip 7-13, 8-19 

listing configured 17-3 

names 17-3, C-15 

naming convention C-9 

offline 7-13, C-19 

offsite 7-13, C-19 

reconfiguring 17-1 

simultaneous backup example 8-17 

subdirectories A-18, C-10 

verifying priority 8-16 
lilDrar}' Unit Manager window 1-16 
libraiy units 

adding 17-1 

automatic inlet 8-8 

barcode support C-15 

contents of A- 19 

deconfiguring 17-14 

drive address C-18 

drive content file A-19 

drive preemption 8-l6 

drive scheduling 7-13, 8-16 

ejecting volumes 7-14 

inlet configuration C-15 



inventory 8-18, 8-20, A-19 
list 7-13 

operations 8-1 

SCSI address C- 17 

slot contents C-15 
life cycle management 7-4 
limit throughput field B-6, B-25 
LM_INLETJGNORE_ON_OPEjN c-19 
LM_MAX_RES1 D ENT_TI ME 8- 1 7 
LM_MIN_RES1DENT_TIME 8-17 
Im.cfg file A-19 

lmconlTig8-4, 17-1 to 17-17, 20-11, C-1 

AUTOCONFIG 17-8 

troubleshooting 17-17 
load balancing 13-6 

excluding a work item from B-34 

excluding work items B-7, B-43, B-54 
local account 

backup client u.ser name B-5, B-17 
local client B-32 

backing up 5-2, B-38 

connecting to tlie server 5-4 

level map for database files B-46 

log files 16-37 

priority for database files B-42 

using the migration backup tag on B-38 

work-item options B-34 
LOCAL_.DA'rABASE 20-2 to 20-3 

backup 19-3, 20-15 to 20-22 

late backup 2-10 

priority 2-10, B-42 

restore 20-1 5 to 20-22 
locked property 11-23, 11-24, 13-12 

performance factors 1 1-24 
locking files 13-11 
log files 3-20, 16-5, 16>35 to 16-37 

backup 5-15 

backup template 1 6-36 

backups.log 16-5, 16-35 

circular 15-4, ,^-19 
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client 16-37 
ebcat.log l6-5, 16-36 
expiring 10-4 
expiring oldest data B-27 
mnti'ault 1 5-3 
recoveries.log l6-5, 16-35 
server log file l6-5 
syslog 15-3 

template_name 16-5, 16-36 

volume management 15-1 

See also reports 
log message format 15-5 
logging level 16-36, B-13, B-77 

debug 16-36 

per file 16-36 

stats 16-36 
logical unit number C-17 

aotochanger C-17 

in SCSI address 17-4 
low watermark 1 1-2, 1 1-10 to 1 1-18, 11-22, 13-19 

M 

magnetic disks 

backing up 3-10 

capacit}'' 10-5 

creating space on 10-13 

utilization of space 13-23 
magnetic tape drive. See drives, tape drives 
magnetic tapes 

backup 3-7 
mailerr script 5-15, B-13, B-80 
mailing tlie daily log file 2-4 
mailok script B-13, B-79, B-80 
manpages 18-1, A-10, A-l6 

backup and restore 18-2 

HSM 18-9 

migration 18-9 

volume management 18-6 
manual backups. See command line interface 
manual operations 3-22 



mapping backup levels. See backup levels, 

mapping 
master staging daemon 12-5 
maximum simultaneous clients B-5, B-24, B-60, 

B-62 
media 

allocating volumes B-76 
backup levels B-1 1 , B-60, B-6l 
choices 11-19 
conserving B-75 
designated by a trail B-60 
DL'r8-27 
ejecting 8-14 
erasable optical 8-27 
expired 7-6 

expiring B-66, B-67, B-68 
importing volumes 10-13 
inserting into library units 8-8 
management B-6l 

maximum trails per media type B-6, B-24 
maximum uses 18-6 
reports 16-10 to 16-11 
retention B-11, B-65, B-67 
reusing B-65, B-67 
rotations 16-10 
tracking B-61 
trailsets B-58, B-60 
transferability 11-22 
using trailsets B-ll 
WORM 7-11, 8-27 
See also volumes 
media duplication 3-18, 9-1, 9-31, 19-5 
append mode 9-5 
automatic 9-8 

backup duplicate report 16-14 
backup or restore 9-2 
canceling 9-17 

concurrent duplications 9-1 1 , 9-24 
Control window 9-20 
determining duplicates 9-24 
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media duplication (continued) 

disabling 9-15 

duplication state 16-12 

duplication staais 16-12 

Duplications window 9-30 

ebreport duplicate 9-27 

ebreport media 9-10 

evmstat 9-11 

failed 9-20, 9-29 

importing a duplicate 9-29 

initiating 9-8 

manual 9-2, 9-8 

manually disabling 9-14 

media list 9-10 

mode 16-12 

new mode 9-5, 9-6 

offline volume 9-14 

padding block 9-4 

pausing 9-1 6 

process 9-2 

reenabling 9-14, 9-15 

reject mount request 9-29 

rescheduling 9-19, 9-25 

rescheduling a single volume 9-14 

rescheduling an offline volume 9-22 

resuming 9-17 

verifying status 9-10 

vmdup 9-3, 9-8 

vmdupcfg 9-3, 9-4, 9-12, 9-15 

vmdupd 9-3, 9-9, 9-13, 9-16, 9-18 
media rotation 

starting new B-74 
media types C-18 
media wear 

with stiige-totape 11-21 
message logging system 15-1 

default configuration file 15-6 

features 1 5-2 

rotating, archiving log files 13-8 
message number 1 5-5 



migration volumes 

verifying information on 13-6 
migration, disabling 13-25 
mntfault log 15-3 
monitor 

active backups 3-22, l6-3 
monitoring magnetic disk space 10-10 
multiple networked clients B-40 
multiplexed storage 3-13 

N 

names 

backup account B-5, B-17 
naming conventions 

Library Manager C-9 
NetWare 

work items 

fields in configuration file B-9 
network 

database vendors 6-3 

limiting the available bandwidth B-25 

multiple networked clients B-40 

server login name B-17 
net%-ork backup of filesystems 16-37 
network clients 

moving files between 13-16 

work item options B-34 
network database 12-10 
network database (MSM) A-22 
network migration sei'ver 12-9 
NFS timeouts D-10 
nightly backup processing 3-10 
NIS password map B-17 
non-miiTored configuration 6-17 
non-stageable filesystems 13-19 
notify daemon (notd) 8-4 
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0 

offline 

Library Manager 7-14, C-19 
offsite 

Library Manager 7-14, C-19 

media 19-5 

storage 

alternate trailsets, of B-70 
online 

backups 5-7 

books 1-12 

catalogs 3-11 

database backups 6-7 

help 1-12 
online documentation xxx 
online help xxx 
optical disks 

compacting 11-27 

P 

padding blocks 9-4, 16-12 

pass count, of tiipe and optical media 11-20 

performance factors 11-5, 11-19, 11-24, 11-31. 13-6 

performing full backups B-15, B-86 

periodic stage out 11-2, 11-22 

automating 13-2 

coordinating with backup 13-5 
permissions 3-19 

backup and recovery B-5, B-17 

recoveiy 

root permissions B-5 
pid. See process ID 
port control 4-1 

checklist 4-10 

clients 4-18 

default port ranges 4-6 
files 4-14 
firewall 4-5 
making changes 4-20 



restrictions 4-4 

the portservices CLI 4-3 
poitservices files 4-14 
prestage 11-2, 13-9 

description of 11-10 

policy 11-15 

reseive 11-13 to 11-15 

watermark 11-10 to 11-15 
preventing stage outs 13-11 
primaiy trailset 3-17, 19-5, B-13, B-59, B-70. 

B~75 
priority B-34 

backup 2-10, 5-5, B-7, B-43 

controlling backup 5-4 

settings B-42 

work item B-41, B-54 
process ID 

in log messages 15-5 
prcx;esses 

Library Manager 8-4 

Volume Manager (vmdaemoii) 8-4 
product description 1-7 
PROM level 17-5 

R 

random filesystems 11-16 
reattaching staged-out files 13-15 
reconfiguration reboot 17-5 
recover 

administrator list B-5, B-23 

client data 3-12 

disabling B-20 
recoveries.log file 5-15, l6-5, 16-36, B-6, B-29 
recovering bitflles 2-9 
recovery 

disaster 19-1, 20-1, 21-1 

log files 5-15 
recreating a baseline automatically B-l4, B-71, 
B-81 

recreating backup catalogs 3-21, 10-2 
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remote diagnostic modem 1-10 
remote GUI launch 1-13 
removing 

libraiy units 17-14 

unnecessary files 10-15 
replacing a damaged disk 21-1 
Report window 1-18 
reports 16-1 to 16-34 

backup 2-3, l6-4, l6-5 
baseline 16-4, 16-27 
completion 16-4, 16-29 
coverage 16-3, 16-4, 16-32 
ftiikire 16-2, 16-31 
history l6-4. 16-15 to 16-18 
media 9-25. 16-10, 16-11 

backup completion 5-14 

backup failure 5-15 

backups.log 5-15 

disaster l6-4, 16-19 to 16-26, 19-4 

filesystems not backed up l6-3 

HSM 11-30 

in crontab 16-1 

installation 20-9 

online 3-22, 16-3 

recoveries.log 5-15 

volumes 16-34 

See also ebreport, log files 
reserved files in VxFS 13-12 
residence priorit)' 11-23, 11-25, 12-6, 13-11 
resident files 

backing up B-8, B-32, B-34 
rest^e 11-33, 13-13 
restore 

cross-client 5-9 

database backups 5-18 

files with ACLs 5-9 

how it u^orks 5-16 

server disaster 20-1 
restore modes 3-20 



restore path 

versus backup path 5-1 6 
Restore window 1-19 
restoring client data 3-12 
Restricted by Application 8-25 
restricted volume template 7-8 
restricted volumes 11-4 
revision levels 

Oracle 6-7 
robot 7-13 

robot. See autochanger 
rotating EDM system logs 2-7 
rotation period 19-5 

14 day B-12, B-75 

28 day B-75 

7 day B-74 

alternating trailsets B-76, B-77, B-85 

autoscheduled 3-7 

custom scheduling B-1 5, B-86 

default B-74 

definition 3-15 

initial backup B-15, B-87 

load balancing B-43 

media B-76 

specifying B-12, B-70, B-74 

vs. keep catalogs period 10-5 
rotation schemes 

full backups during weekend rotations B-82, B-83 

standard B-82, B-83 
RPC 

HSM protocol 12-8 
rvmoper 8-1 



saveset records 
definition of 3-20 
expiring 10-3, B-66, B-68 
online 10-2 

retention period B-11, B-68 
SBus cards 1-9 
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scliedul ing 

automatic 3-4, 5-7, 14-6 

backup 3-3, 14-2, B-82 

catalog processing 1 -4-9 

command line 3-5 

custom 3-4. 3-17, 14-6 

nightly start of backups 14-3 
scheduling backups B-14. B-41 . B-42, B-46, 
B-72 

alternating trailsets B-76 

work groups B-31 
scheduling level 0 backup B-35 
scripts 

epcleatiup 10-4 

findxcpio 5-7 

Imconfig 17-1 to 17-17 

startfind 5-4 
SCSI 

address 17-4, C-17, C-18 

bus slot C-17 
self-describing media 1 1 -22 
sen'er 

concurrent client backups 3-6 

database (HSM) A-22 

server database files 2-10 

sotmatre 3-2, 5-6 

volume catalog A-20 
sei-ver database 12-10 
seiver directories A-2 
sei-ver log files l6-5 

generated 16-5 

See also template log files 
shelf life, of tape and optical media 11-20 
software 

restore after a disaster 20-6 
SPARCsei-ver 1-9 
SRDF configuration 6-16 
stage-in daemon 12-7 
stage-to-tape 13-3 
staggering client staging mns 13-6 



staging 

bulk or periodic 11-2 

bulk stage in 13-10 

candidate list generation 12-5 

event-driven or demand 11-2, 11-12 

file control properties 13-10 

manual stageout 13-9 

to tape 13-3 

watermarks 11-2 
staging templates 

description of 11-4 

how many to create 11-5 
staging trails 11-4 
staging volumes 

compacting 11-27, 13-28 

verifying information on 13-6 
stale files 11-27, 11-29, 11-30, 12-7, 13-28, 13-29, 
13-31 

standard rotations B-82 

how to specify B-83 

See also weekend backups 
start trailset rotations B-12 
startfind 5-4, 5-7 
startup parameter B-87 

backup of new clients B-15 
stats 

backup log level B-77 
store ID 

associated with client store 11-7 
streams from database 6-8 
striped backups, tuning 6-8 
Symmetrix Connect backup 
' EDM 6-13 
Symmetrix non-mirrored configuration 6-17 
Symmetrix Path 1-5, 6-2, 6-12 
syslog messages 15-2 
syslog.conf file 15-1, 15-6 
system 

activity log files 2-4 
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system console 

description 1-10 

messages 15-1 
system logs 

newepoclilog 2-7 

rotating, archiving, tmncating 2-7 
system monitoring 

dbreport 11-30, 13-19 

emfsreport 11-31 to 11-32, 13-19 to 13-23 
system monitoring support GUI 

EDM Symmetrix Connect 1-20, 1-21 

online help 1-21 

SNMP 1-20 

Tivoli 1-20 

T 

tape cartiidges. See magnetic tapes 
tape drives 

mounting volumes into 8-12 

preempting 8-l6 

scheduling 7-13, 8-1 6 
tape libraiy units 1-9 

controlling 7-13 

definitions 1-9 
target ID, SCSI 17-4 

template log files 16-36, B-13, B-l4. B-78 
template_name.log file 16-36 
templates B-45 

backup 3-3 

baseline reports 16-27 
history reports 16-13, 16-16 

volume 7-8, A-20 

See also backup templates 
thi-ashing 11-6. 11-21 
tilde (~) ebadmin A-1 3 
timeouts 

NFS-mounted filesystems D-10 
tmp files, deleting 10-4 



trails 5-13, B-58, B-77 

allocating volumes to 8-23 

baseline 5-20 

default configuration 3-7 

definition of 3-8 

efficiency with fewer B-60 

maximum number per media type B-24 

specification in eb.cfg B-11 
trailsets 3-3, B-31 

alternate 3-17, 19-5, B-13, B-59, B-70, B-75, B-85 

alternating bet^veen B-76 

definition of 3-3 

efficiency with fewer B-60 

fields B-9, B-11 

moving off site B-70 

name B-11, B-60 

primary 3-17, 19-5, B-13, B-59. B-70, B-75 
rotations B-12, B-73 
specifying B-58 

starting new rotations B-12, B-73 

u 

uncataloged volume 7-5 
UNIX remote shell 5-4 
unlabeled volume 7-6 
unlabeled WORM 8-27 
unrestricted volume template 7-8 
unrestiicted volumes 11-4 
unverified volume 7-7 
user ID 

in log messages 15-5 
user names 

backup account B-5, B-17 
user-level NFS daemon 12-4, 12-7 

¥ 

/var/adm/epoch_concise_messages 1 5-3 
verilying priority in the queue 8-l6 
VERITAS 20-7 
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virtual filesystem statistics 11-31 
VM_A LLO W_DUP_SEQ JMPORT 8-26 
vmdaemon 8-3, 8-5, C-5 

failures 8-5 

manual shutdown 8-5 

See also Volume Manager 
vmdup 9-3 

vmdupcfg 9-3, 9-15, 9-1 6 
vmdupd 9-3. 9-9. 9-15, 9-21, 9-23 
volid.dat file A-19. C-15 
volid.dat inventor}' file 8-19 
volume allocation request 8-24 
volume catalog 7-4 
volume management 

allocation, deallocation 8-1 

circular log file 15-4 

cleaning tape drives 8-22 

debug mode C-6 

directoiy structure A-2 

eject media at the CLI 8-1 5 

eject media through the GUI 8-15 

Imconfig 17-2 

logs 15-1 

oven'iew 7-2 

processes 8-2 

re-injecting volumes automatically C-19 

restarting 8-5 

starting 8-1, 8-4 

stopping 8-5 

template catalog A-20 
Volume Manager 

configuration file C-2 

daemon 8-4, C-5 

directoiy 7-3 
volume reports 16-33 
volume sequence numbers 

duplicate 7-5 
volumes 

allocation 8-23, 8-24 

allocation request 8-24 



catalog 

location of A-20 
compaction 2-6 
containing backup data 16-10 
current staging 11-4 
dismounting 8-13 
duplicate 8-26 

duplicate sequence numbers 7-5, 8-26 
erasing 7-7 
foreign 7-6 

inserting in a library unit 8-11 
labeling 7-4, 7-8 
labels, reading 8-12 
life cycle management 7-4 
jiiaximum uses 18-6 
media rotation 16-10 
mount request 8-24 
mounting 8-12 
offline 7-14 
reports 16-34 
restricted by name 8-25 
restricted or unrestricted 11-4 
templates A-20 
uncataloged 7-5 
unlabeled 7-6 
unrestricted 8-25 
unverified 7-7 
use 8-25 
worn 8-27 
VxFS 

resei-ved files 13-12 



watermarks (HSM) 11-10 
window 

Backup Configuration 1-17 

Backup Report 1-18 

HSM Client Installation 1-21 

HSM Configuration 1-22 
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window (continued) 

Library Unit iManager 1-16 

Restore 1-19 
work groups 3-3, 3-7, 3-16 

backing up B-12 

backing up to trailsets B-58, B-6l 
backing up together B-73 
comprising work items B-31 , B-32 
custom scheduling B-15, B-82, B-84 
fields B-6, B-8 
obsolete work items B-35 
specification in eb.cfgB-31 
work items 3-3. 3-6, B-34, B-56, B-57 
backing up die local client B-38 
backup baseline reports 16-27 
backup failure reports B-80 
backup history' reports 16-16 
changing B-35, B-51 
compressing catalogs B-70 
expiring backup catalogs B-68 
expiring backup data B-65, B-67 
expiring saveset records B-68 
fields B-6, B-8 

in work groups B-31, B-32, B-73 
list of fields by type of client B-34 
name B-7, B-8, B-10, B-36, B-51 
obsolete B-35 
order backed up B-7 
priority B-7 

specification in eb.cfg B-7, B-8, B-10, B-32 

specifying witli findxcpio D-7 
working set 11-13 to 11-15 

description of 1 3-20 
WORM media 7-11, 8-27, C-18 
WORM optical disks 8-27 



yellow, green, prestage 11-13 
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